PNG / JPEG / WebP images

Status

What it is

Raster images are common starting artwork or references, but they do not contain embroidery semantics.

Satin Studio behavior

Import places them as locked reference images on the hoop. Use the import rack to fade, hide, center, fit, scale, crop away photo/scanner margins, or start trace tools for each guide while creating editable embroidery objects; they are not automatic guaranteed stitch conversion and they are ignored by machine-file export until you create real embroidery elements.

Versions and variants

Satin Studio checks the file signature and dialect rather than trusting the extension. An unrecognized version remains unopened, with the original file preserved for inspection.

File identification notes

Standard raster image files.

Observed structure notes

• PNG stores chunks after an eight-byte signature. JPEG stores marker-delimited segments between SOI FF D8 and EOI FF D9.
• Raster images are source/reference pixels. They need tracing or assisted digitizing before embroidery objects or stitches exist.
• PNG chunks use big-endian length, four-byte chunk type, payload, and CRC. The first critical chunks normally include IHDR; image data lives in one or more IDAT chunks; IEND terminates the file.
• JPEG files are marker streams. Dimensions and color information are discovered from frame and scan markers, not from a fixed header size.

Structure sketch

Raster images are reference artwork. Their bytes describe pixels, not stitches.

enum RasterArtwork<'a> {
    Png { signature: [u8; 8], chunks: &'a [PngChunk<'a>] }, // 89 50 4E 47 0D 0A 1A 0A
    Jpeg { soi: [u8; 2], segments: &'a [JpegSegment<'a>] }, // FF D8 ... FF D9
}

struct PngChunk<'a> {
    length: u32,
    chunk_type: [u8; 4],
    data: &'a [u8],
    crc: u32,
}

struct JpegSegment<'a> {
    marker: u8,
    payload: &'a [u8],
}

Compatibility evidence

Compatibility checks cover signatures, metadata, command boundaries, malformed records, and files from the machines and software named above. Unsupported variants stop with a specific report instead of being silently rewritten.