8 #ifndef CSCORE_CSCORE_C_H_
9 #define CSCORE_CSCORE_C_H_
49 typedef int CS_Status;
51 typedef int CS_Handle;
52 typedef CS_Handle CS_Property;
53 typedef CS_Handle CS_Listener;
54 typedef CS_Handle CS_Sink;
55 typedef CS_Handle CS_Source;
62 CS_PROPERTY_WRITE_FAILED = 2000,
64 CS_INVALID_HANDLE = -2000,
65 CS_WRONG_HANDLE_SUBTYPE = -2001,
66 CS_INVALID_PROPERTY = -2002,
67 CS_WRONG_PROPERTY_TYPE = -2003,
68 CS_READ_FAILED = -2004,
69 CS_SOURCE_IS_DISCONNECTED = -2005,
70 CS_EMPTY_VALUE = -2006,
72 CS_TELEMETRY_NOT_ENABLED = -2008,
73 CS_UNSUPPORTED_MODE = -2009
95 CS_PIXFMT_UNKNOWN = 0,
128 CS_SOURCE_UNKNOWN = 0,
139 CS_HTTP_MJPGSTREAMER = 1,
147 enum CS_SinkKind { CS_SINK_UNKNOWN = 0, CS_SINK_MJPEG = 2, CS_SINK_CV = 4 };
153 CS_SOURCE_CREATED = 0x0001,
154 CS_SOURCE_DESTROYED = 0x0002,
155 CS_SOURCE_CONNECTED = 0x0004,
156 CS_SOURCE_DISCONNECTED = 0x0008,
157 CS_SOURCE_VIDEOMODES_UPDATED = 0x0010,
158 CS_SOURCE_VIDEOMODE_CHANGED = 0x0020,
159 CS_SOURCE_PROPERTY_CREATED = 0x0040,
160 CS_SOURCE_PROPERTY_VALUE_UPDATED = 0x0080,
161 CS_SOURCE_PROPERTY_CHOICES_UPDATED = 0x0100,
162 CS_SINK_SOURCE_CHANGED = 0x0200,
163 CS_SINK_CREATED = 0x0400,
164 CS_SINK_DESTROYED = 0x0800,
165 CS_SINK_ENABLED = 0x1000,
166 CS_SINK_DISABLED = 0x2000,
167 CS_NETWORK_INTERFACES_CHANGED = 0x4000,
168 CS_TELEMETRY_UPDATED = 0x8000,
169 CS_SINK_PROPERTY_CREATED = 0x10000,
170 CS_SINK_PROPERTY_VALUE_UPDATED = 0x20000,
171 CS_SINK_PROPERTY_CHOICES_UPDATED = 0x40000
178 CS_SOURCE_BYTES_RECEIVED = 1,
179 CS_SOURCE_FRAMES_RECEIVED = 2
220 CS_Property property;
223 const char* valueStr;
243 char* CS_GetPropertyName(CS_Property property, CS_Status* status);
244 int CS_GetProperty(CS_Property property, CS_Status* status);
245 void CS_SetProperty(CS_Property property,
int value, CS_Status* status);
246 int CS_GetPropertyMin(CS_Property property, CS_Status* status);
247 int CS_GetPropertyMax(CS_Property property, CS_Status* status);
248 int CS_GetPropertyStep(CS_Property property, CS_Status* status);
249 int CS_GetPropertyDefault(CS_Property property, CS_Status* status);
250 char* CS_GetStringProperty(CS_Property property, CS_Status* status);
251 void CS_SetStringProperty(CS_Property property,
const char* value,
253 char** CS_GetEnumPropertyChoices(CS_Property property,
int* count,
261 CS_Source CS_CreateUsbCameraDev(
const char* name,
int dev, CS_Status* status);
262 CS_Source CS_CreateUsbCameraPath(
const char* name,
const char* path,
264 CS_Source CS_CreateHttpCamera(
const char* name,
const char* url,
266 CS_Source CS_CreateHttpCameraMulti(
const char* name,
const char** urls,
269 CS_Source CS_CreateCvSource(
const char* name,
const CS_VideoMode* mode,
277 enum CS_SourceKind CS_GetSourceKind(CS_Source source, CS_Status* status);
278 char* CS_GetSourceName(CS_Source source, CS_Status* status);
279 char* CS_GetSourceDescription(CS_Source source, CS_Status* status);
280 uint64_t CS_GetSourceLastFrameTime(CS_Source source, CS_Status* status);
281 void CS_SetSourceConnectionStrategy(CS_Source source,
284 CS_Bool CS_IsSourceConnected(CS_Source source, CS_Status* status);
285 CS_Bool CS_IsSourceEnabled(CS_Source source, CS_Status* status);
286 CS_Property CS_GetSourceProperty(CS_Source source,
const char* name,
288 CS_Property* CS_EnumerateSourceProperties(CS_Source source,
int* count,
290 void CS_GetSourceVideoMode(CS_Source source,
CS_VideoMode* mode,
292 CS_Bool CS_SetSourceVideoMode(CS_Source source,
const CS_VideoMode* mode,
294 CS_Bool CS_SetSourceVideoModeDiscrete(CS_Source source,
296 int width,
int height,
int fps,
298 CS_Bool CS_SetSourcePixelFormat(CS_Source source,
301 CS_Bool CS_SetSourceResolution(CS_Source source,
int width,
int height,
303 CS_Bool CS_SetSourceFPS(CS_Source source,
int fps, CS_Status* status);
304 CS_Bool CS_SetSourceConfigJson(CS_Source source,
const char* config,
306 char* CS_GetSourceConfigJson(CS_Source source, CS_Status* status);
307 CS_VideoMode* CS_EnumerateSourceVideoModes(CS_Source source,
int* count,
309 CS_Sink* CS_EnumerateSourceSinks(CS_Source source,
int* count,
311 CS_Source CS_CopySource(CS_Source source, CS_Status* status);
312 void CS_ReleaseSource(CS_Source source, CS_Status* status);
319 void CS_SetCameraBrightness(CS_Source source,
int brightness,
321 int CS_GetCameraBrightness(CS_Source source, CS_Status* status);
322 void CS_SetCameraWhiteBalanceAuto(CS_Source source, CS_Status* status);
323 void CS_SetCameraWhiteBalanceHoldCurrent(CS_Source source, CS_Status* status);
324 void CS_SetCameraWhiteBalanceManual(CS_Source source,
int value,
326 void CS_SetCameraExposureAuto(CS_Source source, CS_Status* status);
327 void CS_SetCameraExposureHoldCurrent(CS_Source source, CS_Status* status);
328 void CS_SetCameraExposureManual(CS_Source source,
int value, CS_Status* status);
335 char* CS_GetUsbCameraPath(CS_Source source, CS_Status* status);
345 void CS_SetHttpCameraUrls(CS_Source source,
const char** urls,
int count,
347 char** CS_GetHttpCameraUrls(CS_Source source,
int* count, CS_Status* status);
354 void CS_PutSourceFrame(CS_Source source,
struct CvMat* image,
356 void CS_NotifySourceError(CS_Source source,
const char* msg, CS_Status* status);
357 void CS_SetSourceConnected(CS_Source source, CS_Bool connected,
359 void CS_SetSourceDescription(CS_Source source,
const char* description,
361 CS_Property CS_CreateSourceProperty(CS_Source source,
const char* name,
363 int maximum,
int step,
int defaultValue,
364 int value, CS_Status* status);
365 void CS_SetSourceEnumPropertyChoices(CS_Source source, CS_Property property,
366 const char** choices,
int count,
374 CS_Sink CS_CreateMjpegServer(
const char* name,
const char* listenAddress,
375 int port, CS_Status* status);
376 CS_Sink CS_CreateCvSink(
const char* name, CS_Status* status);
377 CS_Sink CS_CreateCvSinkCallback(
const char* name,
void* data,
378 void (*processFrame)(
void* data, uint64_t time),
386 enum CS_SinkKind CS_GetSinkKind(CS_Sink sink, CS_Status* status);
387 char* CS_GetSinkName(CS_Sink sink, CS_Status* status);
388 char* CS_GetSinkDescription(CS_Sink sink, CS_Status* status);
389 CS_Property CS_GetSinkProperty(CS_Sink sink,
const char* name,
391 CS_Property* CS_EnumerateSinkProperties(CS_Sink sink,
int* count,
393 void CS_SetSinkSource(CS_Sink sink, CS_Source source, CS_Status* status);
394 CS_Property CS_GetSinkSourceProperty(CS_Sink sink,
const char* name,
396 CS_Bool CS_SetSinkConfigJson(CS_Sink sink,
const char* config,
398 char* CS_GetSinkConfigJson(CS_Sink sink, CS_Status* status);
399 CS_Source CS_GetSinkSource(CS_Sink sink, CS_Status* status);
400 CS_Sink CS_CopySink(CS_Sink sink, CS_Status* status);
401 void CS_ReleaseSink(CS_Sink sink, CS_Status* status);
408 char* CS_GetMjpegServerListenAddress(CS_Sink sink, CS_Status* status);
409 int CS_GetMjpegServerPort(CS_Sink sink, CS_Status* status);
416 void CS_SetSinkDescription(CS_Sink sink,
const char* description,
418 uint64_t CS_GrabSinkFrame(CS_Sink sink,
struct CvMat* image, CS_Status* status);
419 uint64_t CS_GrabSinkFrameTimeout(CS_Sink sink,
struct CvMat* image,
420 double timeout, CS_Status* status);
421 char* CS_GetSinkError(CS_Sink sink, CS_Status* status);
422 void CS_SetSinkEnabled(CS_Sink sink, CS_Bool enabled, CS_Status* status);
429 void CS_SetListenerOnStart(
void (*onStart)(
void* data),
void* data);
430 void CS_SetListenerOnExit(
void (*onExit)(
void* data),
void* data);
431 CS_Listener CS_AddListener(
432 void* data,
void (*callback)(
void* data,
const struct CS_Event* event),
433 int eventMask,
int immediateNotify, CS_Status* status);
435 void CS_RemoveListener(CS_Listener handle, CS_Status* status);
438 int CS_NotifierDestroyed(
void);
444 void CS_SetTelemetryPeriod(
double seconds);
445 double CS_GetTelemetryElapsedTime(
void);
448 double CS_GetTelemetryAverageValue(CS_Handle handle,
enum CS_TelemetryKind kind,
456 typedef void (*CS_LogFunc)(
unsigned int level,
const char* file,
457 unsigned int line,
const char* msg);
458 void CS_SetLogger(CS_LogFunc func,
unsigned int min_level);
459 void CS_SetDefaultLogger(
unsigned int min_level);
466 void CS_Shutdown(
void);
477 CS_Source* CS_EnumerateSources(
int* count, CS_Status* status);
478 void CS_ReleaseEnumeratedSources(CS_Source* sources,
int count);
480 CS_Sink* CS_EnumerateSinks(
int* count, CS_Status* status);
481 void CS_ReleaseEnumeratedSinks(CS_Sink* sinks,
int count);
483 void CS_FreeString(
char* str);
484 void CS_FreeEnumPropertyChoices(
char** choices,
int count);
486 void CS_FreeHttpCameraUrls(
char** urls,
int count);
488 void CS_FreeEnumeratedProperties(CS_Property* properties,
int count);
489 void CS_FreeEnumeratedVideoModes(
CS_VideoMode* modes,
int count);
491 char* CS_GetHostname();
493 char** CS_GetNetworkInterfaces(
int* count);
494 void CS_FreeNetworkInterfaces(
char** interfaces,
int count);
503 #endif // CSCORE_CSCORE_C_H_
CS_StatusValue
Status values.
Definition: cscore_c.h:61
CS_PixelFormat
Pixel formats.
Definition: cscore_c.h:94
CS_TelemetryKind
Telemetry kinds.
Definition: cscore_c.h:177
Try to keep the connection open regardless of whether any sinks are connected.
Definition: cscore_c.h:194
CS_LogLevel
Logging levels.
Definition: cscore_c.h:79
struct CS_VideoMode CS_VideoMode
Video mode.
CS_HttpCameraKind
HTTP Camera kinds.
Definition: cscore_c.h:137
CS_SinkKind
Sink kinds.
Definition: cscore_c.h:147
USB camera infomation.
Definition: cscore_c.h:229
Never open the connection.
Definition: cscore_c.h:200
Automatically connect or disconnect based on whether any sinks are connected to this source...
Definition: cscore_c.h:188
CS_ConnectionStrategy
Connection strategy.
Definition: cscore_c.h:183
CS_SourceKind
Source kinds.
Definition: cscore_c.h:127
CS_PropertyKind
Property kinds.
Definition: cscore_c.h:116
CS_EventKind
Listener event kinds.
Definition: cscore_c.h:152
Listener event.
Definition: cscore_c.h:206
struct CS_UsbCameraInfo CS_UsbCameraInfo
USB camera infomation.
Video mode.
Definition: cscore_c.h:106