Neon 3D Symbol GIF

Purpose

Use the bundled renderer to generate smooth floating 3D neon symbol GIFs. The default preset recreates the red glowing pentagram rotation style: black background, soft particle field, floating shadow, anti-aliased 3D rotation, neon glow, no text, and no scanlines.

Quick Commands

Set paths:

SKILL_DIR="$HOME/.codex/skills/neon-3d-symbol-gif"
PY="/Users/tec/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3"
[ -x "$PY" ] || PY="python3"

Generate the default smooth floating pentagram:

"$PY" "$SKILL_DIR/scripts/generate_neon_3d_symbol_gif.py" \
  --symbol pentagram \
  --out "$PWD/floating-3d-pentagram-rotation.gif" \
  --preview-sheet "$PWD/floating-3d-pentagram-rotation-contact.png"

Generate a faster/lighter draft:

"$PY" "$SKILL_DIR/scripts/generate_neon_3d_symbol_gif.py" \
  --frames 48 \
  --size 512 \
  --out "$PWD/pentagram-draft.gif"

Workflow

1. Use the default settings for polished output: 720x720, 120 frames, 24ms frame duration.
2. Use --size for square dimensions; 720 is a good balance of quality and file size.
3. Use --frames to control smoothness. Keep 96-144 for super smooth loops.
4. Use --duration to control speed. 24ms is fast and fluid; 32-45ms is slower and heavier.
5. Use --color red|white|cyan|violet|green|gold or --hex "#ff3340" for glow color.
6. Generate a --preview-sheet when visual QA is useful.

Implementation Notes

• Script: scripts/generate_neon_3d_symbol_gif.py
• Current symbol preset: pentagram
• Default size: 720
• Default frame count: 120
• Default duration: 24 ms per frame
• Default output: floating-3d-pentagram-rotation.gif

The script requires Pillow. Prefer the bundled Codex primary runtime Python when available because it includes a working ARM64 Pillow build on this machine.

Keep outputs practical: high-frame neon GIFs can get large quickly. If a file is too heavy, lower --size, --frames, or --particles.

Style Guide

• Keep the composition clean: centered floating object, black field, soft glow, no labels.
• Avoid scanlines, borders, titles, or stamps unless the user asks.
• Use red for the signature occult neon look; use white/cyan/violet when the user wants cleaner cyber or icon vibes.
• For profile/icon loops, prefer square outputs: 512, 720, or 1024.