Method

GrlOperationOptionsobey_caps

since: 0.2.0

Declaration [src]

gboolean
grl_operation_options_obey_caps (
  GrlOperationOptions* options,
  GrlCaps* caps,
  GrlOperationOptions** supported_options,
  GrlOperationOptions** unsupported_options
)

Description [src]

Check whether options obey to caps. Optionally provide the options that match (respectively don’t match) caps in supported_options (respectively unsupported_options). This would typically (but not necessarily) be used with a GrlOperationOptions instance that was created with NULL caps.

Available since: 0.2.0

Parameters

caps

Type: GrlCaps

Capabilities against which we want to test options.

The data is owned by the caller of the method.

supported_options

Type: GrlOperationOptions

If not NULL, will contain a newly-allocated GrlOperationOptions instance containing all the values of options that match caps.

The argument will be set by the function.

The caller of the method takes ownership of the data, and is responsible for freeing it.

unsupported_options

Type: GrlOperationOptions

If not NULL, will contain a newly-allocated GrlOperationOptions instance containing all the values of options that do not match caps.

The argument will be set by the function.

The caller of the method takes ownership of the data, and is responsible for freeing it.

Return value

Type: gboolean

TRUE if options obey to caps, FALSE otherwise.