CodecMedia API 1.2.1 | Java API Reference

me.tamkungz.codecmedia3

class CodecMediaEntry point for creating CodecMedia engine instances. interface CodecMediaEngineCore media engine contract used by {@link CodecMedia}. The current default implementation focuses on practical probing/validation workflows and light-weight conversion routing. For richer embedded metadata (for example MP3 album cover/APIC), callers should treat {@link #probe(Path)} output as technical media info rather than full tag extraction. class CodecMediaExceptionpublic class CodecMediaException extends Exception

me.tamkungz.codecmedia.internal.audio.aiff3

class AiffCodecpublic final class AiffCodec class AiffParserpublic final class AiffParser record AiffProbeInfopublic record AiffProbeInfo( long durationMillis, int bitrateKbps, int sampleRate, int channels, BitrateMode bitrateMode )

me.tamkungz.codecmedia.internal.audio1

enum BitrateModepublic enum BitrateMode

me.tamkungz.codecmedia.internal.audio.flac3

class FlacCodecpublic final class FlacCodec class FlacParserpublic final class FlacParser record FlacProbeInfopublic record FlacProbeInfo( String codec, int sampleRate, int channels, int bitsPerSample, int bitrateKbps, BitrateMode bitrateMode, long durationMillis )

me.tamkungz.codecmedia.internal.audio.mp36

class Mp3Codecpublic final class Mp3Codec class Mp3DecoderMP3 decoder that decodes into PCM signed 16-bit little-endian samples. The implementation relies on Java Sound SPI available at runtime. class Mp3Id3v1TagMinimal ID3v1 reader/writer for embedded MP3 metadata support. class Mp3Parserpublic final class Mp3Parser record Mp3ProbeInfopublic record Mp3ProbeInfo( String codec, int sampleRate, int channels, int bitrateKbps, BitrateMode bitrateMode, long durationMillis ) class PureJavaMp3DecoderExperimental pure-Java MP3 decoder backend. This implementation is intentionally lightweight and does not reconstruct the original Layer III spectral data yet. It parses valid MP3 frame headers and synthesizes a deterministic PCM timeline from frame cadence so callers can run in runtime environments where Java Sound MP3 SPI is unavailable.

me.tamkungz.codecmedia.internal.audio.ogg3

class OggCodecpublic final class OggCodec class OggParserpublic final class OggParser record OggProbeInfopublic record OggProbeInfo( String codec, int sampleRate, int channels, int bitrateKbps, BitrateMode bitrateMode, long durationMillis )

me.tamkungz.codecmedia.internal.audio.wav3

class WavCodecpublic final class WavCodec class WavParserpublic final class WavParser record WavProbeInfopublic record WavProbeInfo( long durationMillis, int bitrateKbps, int sampleRate, int channels, BitrateMode bitrateMode )

me.tamkungz.codecmedia.internal.convert13

interface ConversionHubpublic interface ConversionHub record ConversionRequestpublic record ConversionRequest( Path input, Path output, String sourceExtension, String targetExtension, MediaType sourceMediaType, MediaType targetMediaType, ConversionOptions options ) enum ConversionRoutepublic enum ConversionRoute class ConversionRouteResolverpublic final class ConversionRouteResolver class DefaultConversionHubpublic final class DefaultConversionHub implements ConversionHub class ImageTranscodeConverterpublic final class ImageTranscodeConverter implements MediaConverter class JavaSoundAudioTranscodeConverterAudio transcoder that uses JDK Java Sound SPI only (zero external dependencies). Supported target formats are constrained to Java Sound built-ins: WAV/AIFF/AU. interface MediaConverterpublic interface MediaConverter class Mp3PcmWavConverterMP3 decoder-backed converter for MP3 -> PCM/WAV. class Mp4MovToM4aRemuxConverterContainer-level audio remux path for MP4/MOV -> M4A without audio re-encode. Implementation strategy is intentionally conservative and zero-dependency: rewrite non-audio {@code trak} boxes in {@code moov} to {@code free} (same size), preserving all chunk offsets and payload bytes. class SameFormatCopyConverterpublic final class SameFormatCopyConverter implements MediaConverter class UnsupportedRouteConverterpublic final class UnsupportedRouteConverter implements MediaConverter class WavPcmConverterWAV <-> PCM converter. - WAV -> PCM: extracts raw PCM payload from the WAV {@code data} chunk. - PCM -> WAV: wraps raw PCM bytes in a canonical 16-bit LE PCM WAV container (44.1kHz, stereo).

me.tamkungz.codecmedia.internal.image.bmp3

class BmpCodecpublic final class BmpCodec class BmpParserpublic final class BmpParser record BmpProbeInfopublic record BmpProbeInfo( int width, int height, int bitsPerPixel )

me.tamkungz.codecmedia.internal.image.heif3

class HeifCodecHEIF/HEIC/AVIF decode/encode bridge backed by {@link ImageIO}. Note: standard JDK runtimes may not include HEIF/AVIF reader/writer SPI by default. A compatible ImageIO plugin may be required at runtime. class HeifParserpublic final class HeifParser record HeifProbeInfopublic record HeifProbeInfo( String majorBrand, Integer width, Integer height, Integer bitDepth )

me.tamkungz.codecmedia.internal.image.jpeg3

class JpegCodecpublic final class JpegCodec class JpegParserpublic final class JpegParser record JpegProbeInfopublic record JpegProbeInfo( int width, int height, int bitsPerSample, int channels )

me.tamkungz.codecmedia.internal.image.png3

class PngCodecpublic final class PngCodec class PngParserpublic final class PngParser record PngProbeInfopublic record PngProbeInfo( int width, int height, int bitDepth, int colorType )

me.tamkungz.codecmedia.internal.image.tiff3

class TiffCodecTIFF decode/encode bridge backed by {@link ImageIO}. Note: standard JDK runtimes may not include TIFF reader/writer SPI by default. A compatible ImageIO plugin may be required at runtime. class TiffParserpublic final class TiffParser record TiffProbeInfopublic record TiffProbeInfo( int width, int height, Integer bitDepth )

me.tamkungz.codecmedia.internal.image.webp3

class WebpCodecWebP image decode/encode bridge backed by {@link ImageIO}. Note: standard JDK runtimes do not always include a WebP reader/writer SPI. A compatible plugin must be present in the runtime for decode/encode to work. class WebpParserpublic final class WebpParser record WebpProbeInfopublic record WebpProbeInfo( int width, int height, Integer bitDepth )

me.tamkungz.codecmedia.internal.io1

class ByteArrayReaderpublic final class ByteArrayReader

me.tamkungz.codecmedia.internal1

class StubCodecMediaEngineTemporary stub implementation to bootstrap API integration.

me.tamkungz.codecmedia.internal.video.mov3

class MovCodecpublic final class MovCodec class MovParserpublic final class MovParser record MovProbeInfopublic record MovProbeInfo( Long durationMillis, Integer width, Integer height, String majorBrand, String videoCodec, String audioCodec, Integer sampleRate, Integer channels, Double frameRate, Integer videoBitrateKbps, Integer audioBitrateKbps, Integer bitDepth, String displayAspectRatio )

me.tamkungz.codecmedia.internal.video.mp43

class Mp4Codecpublic final class Mp4Codec class Mp4Parserpublic final class Mp4Parser record Mp4ProbeInfopublic record Mp4ProbeInfo( Long durationMillis, Integer width, Integer height, String majorBrand, String videoCodec, String audioCodec, Integer sampleRate, Integer channels, Double frameRate, Integer videoBitrateKbps, Integer audioBitrateKbps, Integer bitDepth, String displayAspectRatio )

me.tamkungz.codecmedia.internal.video.webm3

class WebmCodecpublic final class WebmCodec class WebmParserpublic final class WebmParser record WebmProbeInfopublic record WebmProbeInfo( Long durationMillis, Integer width, Integer height, String videoCodec, String audioCodec, Integer sampleRate, Integer channels, Double frameRate, Integer videoBitrateKbps, Integer audioBitrateKbps, Integer bitDepth, String displayAspectRatio )

me.tamkungz.codecmedia.model9

record ConversionResultpublic record ConversionResult( Path outputFile, String format, boolean reencoded ) record ExtractionResultpublic record ExtractionResult( Path outputFile, String format ) enum MediaTypepublic enum MediaType record Metadatapublic record Metadata(Map<String, String> entries) record PlaybackResultpublic record PlaybackResult( boolean started, String backend, MediaType mediaType, /** Optional diagnostic message; may be {@code null} when no message is produced. */ String message ) record ProbeResultpublic record ProbeResult( Path input, String mimeType, String extension, MediaType mediaType, Long durationMillis, List<StreamInfo> streams, Map<String, String> tags ) record StreamInfopublic record StreamInfo( int index, StreamKind kind, String codec, Integer bitrateKbps, Integer sampleRate, Integer channels, Integer width, Integer height, Double frameRate ) enum StreamKindpublic enum StreamKind record ValidationResultpublic record ValidationResult( boolean valid, List<String> warnings, List<String> errors )

me.tamkungz.codecmedia.options4

record AudioExtractOptionspublic record AudioExtractOptions( String targetFormat, Integer bitrateKbps, Integer streamIndex ) record ConversionOptionspublic record ConversionOptions( String targetFormat, String preset, boolean overwrite ) record PlaybackOptionspublic record PlaybackOptions( boolean dryRun, boolean allowExternalApp ) record ValidationOptionspublic record ValidationOptions( boolean strict, long maxBytes )