Bisect Documentation

Bisect is a unified creative platform that connects four powerful studios: Vector graphics editing, 3D scene manipulation, video timeline editing, and AI-powered texture generation. This documentation covers all features and workflows across each studio.

Quick Start

  1. 1

    Choose a Studio

    Select Vector, 3D, or Tex Factory based on your creative needs.

  2. 2

    Import or Create

    Upload existing assets or start from scratch with built-in tools.

  3. 3

    Use AI Features

    Leverage Gemini, GPT-4o, and Claude for intelligent assistance.

  4. 4

    Export

    Download production-ready assets in multiple formats.

Vector Studio

Canvas-based SVG editing with AI assistance

Canvas & Tools

The Vector Studio uses an HTML5 Canvas rendering engine with real-time SVG path generation.

Selection Tool

Click to select paths. Shift+click for multi-select. Drag to move.

Pen Tool

Click to add points. Drag to create Bézier curves. Double-click to close path.

Pan & Zoom

Scroll to zoom. Space+drag to pan. Fit to view with Home key.

Layers Panel

Organize paths in layers. Drag to reorder. Toggle visibility.

Keyboard Shortcuts

V Selection
P Pen
Ctrl+Z Undo
Ctrl+S Save

AI Vectorization

Convert raster images (PNG, JPG, WebP) to clean SVG paths using Gemini AI.

Logo Mode:Optimized for clean geometric shapes with minimal colors.
Icon Mode:Simple shapes with consistent stroke width, normalized to square viewBox.
Illustration Mode:Detailed vector art with varied line weights and richer color palette.

Export Formats

.svg

Standard SVG with optimized paths

.png

Rasterized at 1x, 2x, 4x resolution

.tsx

React component with TypeScript

.vue

Vue 3 SFC component

3D Studio

React Three Fiber-powered 3D scene editing with AI

Viewport Controls

Navigate the 3D viewport using Blender-style mouse and keyboard controls.

Left Click

Select objects in the scene

Middle Mouse Button

Orbit camera around scene

MMB + Shift

Pan camera

Right Click + Drag

Pan camera (alternative)

Scroll Wheel

Zoom in/out

H

Toggle scene hierarchy panel

Transform Controls (Blender-style)

When an object is selected, use these keyboard shortcuts to switch transform modes:

G

Grab / Move

R

Rotate

S

Scale

Object Actions

Delete Remove object
Backspace Remove object

Import Formats

Drag and drop files onto the canvas or use the file picker. Models are auto-scaled and centered at origin.

.glb

Recommended. Binary GLTF with embedded textures.

.gltf

JSON format with external textures. Full PBR support.

.obj

Wavefront OBJ. Basic geometry without materials.

.splinecode

Spline.design scenes with materials and animations.

Export from Blender, Maya, Cinema 4D, Spline, or any 3D software.

Primitive Shapes

Use the shape toolbar at the bottom of the canvas to add basic 3D primitives to your scene.

BoxSpherePlane

AI Scene Editing

Use natural language commands to modify your 3D scene. Powered by GPT-4o vision.

> "Make the sphere metallic blue"
Applying StandardMaterial with color #2563eb and metalness 0.8...
Done.
Color changes: "Make X red/blue/green"
Material changes: "Make X metallic/glass/matte"
Transforms: "Move X up/left/forward"
Visibility: "Hide/show X"

Material Library

600+ built-in material presets organized by category.

MetalsWoodStoneFabricGlassPlasticCeramicOrganic

Video Studio

Timeline-based video editing with 3D integration

Timeline & Tracks

A multi-track timeline editor for compositing video, audio, and image layers.

Video Tracks

Import MP4, WebM, MOV files. Trim, split, and arrange clips on the timeline.

Image Layers

Add PNG, JPG, GIF overlays. Set duration and positioning.

Clip Editing

Drag edges to trim. Double-click to split. Drag to reorder clips.

Playback Controls

Scrub timeline, play/pause, set playback speed, and zoom.

Keyboard Shortcuts

Space Play/Pause
Delete Remove clip
Ctrl+Z Undo
Ctrl+S Save

AI Assistant

Use natural language to edit your video timeline. Powered by Claude AI.

> "Add a 3 second fade transition between clips"
Analyzing timeline structure...
Added crossfade between Clip_1 and Clip_2
Timeline edits: "Move clip X to the end"
Duration changes: "Trim clip to 5 seconds"
Track management: "Add a new audio track"

Video Textures for 3D

Use videos from your timeline as textures on 3D objects in the 3D Studio.

Cross-Studio Integration

Save your video project, then apply it as a video texture in the 3D Studio. Videos play in real-time on 3D geometry with support for UV mapping.

MP4 SupportWebM SupportLoop PlaybackAlpha Channel

Export & Save

Save video projects to your asset library or export as video files.

Save as Asset

Store project in your library with metadata and tags

.mp4

H.264 encoded video for web and playback

.webm

VP9 encoded for web optimization

.json

Project file for later editing

Tex Factory

AI-powered MatCap and PBR texture generation

MatCap Generation

Generate Material Capture textures from text prompts. MatCaps encode lighting and material properties in a single spherical texture.

Example Prompts

  • • "Chrome metal with soft highlights"
  • • "Matte clay with subtle ambient occlusion"
  • • "Iridescent pearl finish"
  • • "Brushed copper with warm tones"
1K Resolution2K UpscalePNG Export

PBR Texture Sets

Generate complete PBR texture sets from a single prompt. Includes auto-generated maps.

Albedo

Base color map via Gemini

Normal

Auto-generated with Sobel

Roughness

Luminance extraction

Real-Time 3D Preview

Preview generated textures on 3D geometry in real-time.

SphereCubeTorusPlane

API Reference

REST API and CLI documentation

REST Endpoints

POST/api/vectorize

Convert raster image to SVG

POST/api/optimize

Optimize and compress SVG

POST/api/texture

Generate MatCap or PBR texture

CLI Usage

# Install globally
npm install -g @bisect/cli
# Vectorize an image
bisect convert input.png -o output.svg
# Batch convert directory
bisect convert ./images/*.png --output ./svg
# Watch mode
bisect watch ./assets --output ./dist

Ready to Start?