/** * FreeRDP: A Remote Desktop Protocol Implementation * RDP Codecs * * Copyright 2014 Marc-Andre Moreau * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #ifndef FREERDP_CODECS_H #define FREERDP_CODECS_H #include #include #include #include #include #include #include #include #include #include typedef enum { FREERDP_CODEC_INTERLEAVED = 0x00000001, FREERDP_CODEC_PLANAR = 0x00000002, FREERDP_CODEC_NSCODEC = 0x00000004, FREERDP_CODEC_REMOTEFX = 0x00000008, FREERDP_CODEC_CLEARCODEC = 0x00000010, FREERDP_CODEC_ALPHACODEC = 0x00000020, FREERDP_CODEC_PROGRESSIVE = 0x00000040, FREERDP_CODEC_AVC420 = 0x00000080, FREERDP_CODEC_AVC444 = 0x00000100, FREERDP_CODEC_ALL = 0x7FFFFFFF /* C enum types are restricted to int */ } FreeRDP_CodecFlags; #ifdef __cplusplus extern "C" { #endif struct rdp_codecs { UINT32 ThreadingFlags; /** @since version 3.6.0 */ RFX_CONTEXT* rfx; NSC_CONTEXT* nsc; H264_CONTEXT* h264; CLEAR_CONTEXT* clear; PROGRESSIVE_CONTEXT* progressive; BITMAP_PLANAR_CONTEXT* planar; BITMAP_INTERLEAVED_CONTEXT* interleaved; }; typedef struct rdp_codecs rdpCodecs; WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_client_codecs_prepare(rdpCodecs* codecs, UINT32 flags, UINT32 width, UINT32 height); WINPR_ATTR_NODISCARD FREERDP_API BOOL freerdp_client_codecs_reset(rdpCodecs* codecs, UINT32 flags, UINT32 width, UINT32 height); /** * @brief Free a rdpCodecs instance * @param codecs A pointer to a rdpCodecs instance or nullptr * @since version 3.6.0 */ FREERDP_API void freerdp_client_codecs_free(rdpCodecs* codecs); /** * @brief Allocate a rdpCodecs instance. * @return A newly allocated instance or \b nullptr in case of failure. * @since version 3.6.0 */ WINPR_ATTR_MALLOC(freerdp_client_codecs_free, 1) WINPR_ATTR_NODISCARD FREERDP_API rdpCodecs* freerdp_client_codecs_new(UINT32 ThreadingFlags); #if !defined(WITHOUT_FREERDP_3x_DEPRECATED) WINPR_DEPRECATED_VAR("[since 3.6.0] Use freerdp_client_codecs_free", FREERDP_API void codecs_free(rdpCodecs* codecs)); WINPR_DEPRECATED_VAR( "[since 3.6.0] Use freerdp_client_codecs_new", WINPR_ATTR_MALLOC(codecs_free, 1) WINPR_ATTR_NODISCARD FREERDP_API rdpCodecs* codecs_new(rdpContext* context)); #endif /** @brief return a string representation of the given codecid * * @param id The codec to stringify * @return The name of the codecid * @since version 3.18.0 */ WINPR_ATTR_NODISCARD FREERDP_API const char* freerdp_codec_id_to_str(UINT32 id); #ifdef __cplusplus } #endif #endif /* FREERDP_CODECS_H */