ISCC - Configuration Options#
SDK options can be configured using environment variables. Variables are defined as
class-atributes on the SdkOptions
instance.
Example how to access configuration options
SdkOptions #
SDK Configuration Options
granular
class-attribute
instance-attribute
#
granular: bool = Field(
default=False,
description="ISCC_SDK_GRANULAR - Generate additional granular fingerprints for ISCC-CODES",
)
process_container
class-attribute
instance-attribute
#
process_container: bool = Field(
default=False,
description="ISCC_SDK_PROCESS_CONTAINER - Process embedded elements in container formats",
)
min_image_size
class-attribute
instance-attribute
#
min_image_size: int = Field(
default=256,
description="ISCC_SDK_MIN_IMAGE_SIZE - Minimum image size in pixels for container processing",
)
add_units
class-attribute
instance-attribute
#
add_units: bool = Field(
default=False,
description="ISCC_SDK_ADD_UNITS - Add ISCC-UNITS to ISCC metadata (in 'units' property)",
)
bits
class-attribute
instance-attribute
#
bits: int = Field(
default=64,
description="ISCC_SDK_BITS - Bit size of ISCC-UNITS in ISCC metadata (in 'units' property)",
)
wide
class-attribute
instance-attribute
#
wide: bool = Field(
default=False,
description="ISCC_SDK_WIDE - For ISCC-SUM with Data & Instance codes only support wide mode",
)
extract_meta
class-attribute
instance-attribute
#
extract_meta: bool = Field(
default=True,
description="ISCC_EXTRACT_META - Extract metadata from digital assets (defaut: True)",
)
create_meta
class-attribute
instance-attribute
#
create_meta: bool = Field(
default=True,
description="ISCC_CREATE_META - Create Meta-Code from embedded metadata (defaut: True)",
)
create_thumb
class-attribute
instance-attribute
#
create_thumb: bool = Field(
default=True,
description="ISCC_CREATE_THUMBNAIL - Create thumbail for digital assets (defaut: True)",
)
image_exif_transpose
class-attribute
instance-attribute
#
image_exif_transpose: bool = Field(
default=True,
description="ISCC_SDK_IMAGE_EXIF_TRANSPOSE - Transpose image according to EXIF Orientation tag",
)
image_fill_transparency
class-attribute
instance-attribute
#
image_fill_transparency: bool = Field(
default=True,
description="ISCC_SDK_IMAGE_FILL_TRANSPARENCY - Add white background to image if it has alpha transparency",
)
image_trim_border
class-attribute
instance-attribute
#
image_trim_border: bool = Field(
default=True,
description="ISCC_SDK_IMAGE_TRIM_BORDER - Crop empty borders of images",
)
image_thumbnail_size
class-attribute
instance-attribute
#
image_thumbnail_size: int = Field(
default=128,
description="ISCC_SDK_IMAGE_THUMBNAIL_SIZE - Size of larger side of thumbnail in number of pixels",
)
image_thumbnail_quality
class-attribute
instance-attribute
#
image_thumbnail_quality: int = Field(
default=30,
description="ISCC_SDK_IMAGE_THUMBNAIL_QUALITY - Thumbnail image compression setting (0-100)",
)
image_thumbnail_format
class-attribute
instance-attribute
#
image_thumbnail_format: Literal["JPEG", "WEBP", "AVIF"] = (
Field(
default="WEBP",
description="ISCC_SDK_IMAGE_THUMBNAIL_FORMAT - Format for thumbnail images (JPEG, WEBP, or AVIF)",
)
)
image_max_pixels
class-attribute
instance-attribute
#
image_max_pixels: Optional[int] = Field(
default=128000000,
description="ISCC_SDK_IMAGE_MAX_PIXELS - Maximum number of pixels allowed for processing (default 128Mpx / 0.5GB RGB)",
)
text_keep
class-attribute
instance-attribute
#
text_keep: bool = Field(
default=False,
description="ISCC_SDK_TEXT_KEEP - Keep extracted plainext on `IsccMata.text` property",
)
text_avg_chunk_size
class-attribute
instance-attribute
#
text_avg_chunk_size: int = Field(
default=512,
description="ISCC_SDK_TEXT_AVG_CHUNK_SIZE - Avg number of characters per text chunk for Content-Code Text granular fingerprints",
)
video_fps
class-attribute
instance-attribute
#
video_fps: int = Field(
default=5,
description="ISCC_SDK_VIDEO_FPS - Frames per second to process for video hash (ignored when 0).",
)
video_scene_limit
class-attribute
instance-attribute
#
video_scene_limit: float = Field(
default=0.4,
description="ISCC_SDK_VIDEO_SCENE_LIMIT - Threshold value above which a scene cut is created (default 0.4)",
)
video_store_mp7sig
class-attribute
instance-attribute
#
video_store_mp7sig: bool = Field(
default=False,
description="ISCC_SDK_VIDEO_STORE_MP7SIG - Store extracted MP7 Video as <videofile>.iscc.mp7sig",
)
fallback
class-attribute
instance-attribute
#
fallback: bool = Field(
default=False,
description="ISCC_SDK_FALLBACK - Create 2-UNIT ISCC-SUM for unsupported media types",
)
override #
Returns an updated and validated deep copy of the current settings instance.