Graphic Block

A graphic block is the unified block type for any visual content in a CE.SDK scene. Every image, every shape, every video clip, every sticker, every background: all of them are graphic blocks. They share the same API surface, the same property set, and the same composition model.

This is what makes “drag an image” and “drag a shape” and “drag a video” all work the same way in the editor. Same selection model, same transform handles, same right-click menu, same export pipeline. The difference between an image and a shape is what is inside the block, not what kind of block it is.

A graphic block has three composable parts.

Shape. The geometric boundary. Defines the block’s outline and the region that clips its fill. A graphic block created without a shape is invisible: the engine has nothing to render the fill into.

Fill. The content rendered inside the shape boundary. An image, a video, a solid color, or a gradient. The fill can be replaced at any time without replacing the block itself: this is the mechanism behind the Replace action in the editor.

Effects. Optional visual processing layers applied on top of the fill within the shape. Multiple effects can stack and reorder freely.

Because the three parts are independent objects, each can be changed without affecting the others. Swap a rectangle for an ellipse, the image inside reflows to the new boundary. Swap an image for a video, the shape stays put. Add a blur effect, neither the shape nor the fill underneath changes.

Since every visual element shares the graphic type, products that need to treat images differently from stickers (or product images differently from logos) rely on Block Kind for the distinction. Kind is a free-form semantic label that does not affect which APIs apply but does tell the editor and product code what a block represents.

An Unsplash image arrives with Kind image. A sticker from the sticker library arrives with Kind sticker. A template’s product placeholder might carry Kind product-image. Find-by-kind queries are how automation pipelines locate the right block to populate.

See shape for the geometry side, fill for the content side, effects for the visual processing layer, and block for the broader block primitive.