--- description: "Prompts prontos para criar visuais com o tdmcp, o servidor MCP para TouchDesigner — feedback, áudio-reativo, partículas, arte generativa e mais." --- # Receitas de prompt Copie, troque as palavras e deixe do seu jeito. Estão agrupadas pelo que você quer criar. Depois de qualquer build, você sempre pode dizer **"me mostre um preview"** e então ajustar: *"mais quente", "mais devagar", "mais contraste", "adicione um glitch".* ::: tip Como descrever Descreva o **resultado e a sensação**, não os nós. "Um túnel lento, hipnótico e azul-profundo" funciona melhor do que nomear operadores. A IA escolhe os operadores. ::: A mídia desta página fica reservada para o resultado visual ou a superfície performável que o prompt cria. Se o prompt gera relatório, config, README ou health check, ele fica só em texto em vez de mostrar uma ilustração decorativa do comando. Não anexe um clipe até ele ter sido capturado da saída do TouchDesigner que o prompt produziu via tdmcp. ## Starters de receita (receitas first-party validadas) Use estes quando quiser começar por uma receita first-party validada e só depois pedir uma passada criativa. São bons para workshop e ensaio porque partem de redes checadas por schema, não de topologia inventada do zero. > *"Aplique `audio_reactive_basic`, use um tom de teste se o mic não estiver > disponível, e me mostre o caminho do Null de áudio dirigindo a cor de saída."*

*Uma cadeia compacta de audio-in / spectrum / RMS com Null CHOP estável. A cor da saída TOP já está ligada ao nível RMS por expressões, então o quadro pulsa com o áudio de imediato.* > *"Aplique `keyframe_animation_basic`, adicione cinco keyframes legíveis de câmera > ou objeto e exponha um controle Speed para eu ensaiar o movimento sem abrir o > grafo."*

*O starter com Animation COMP coloca movimento declarativo primeiro: você autoria os canais no Animation Editor do TD e usa o CHOP resultante para guiar o look.* > *"Aplique `pose_skeleton_standalone` com a tabela interna de landmarks, renderize > juntas como pontos brilhantes e ossos, e deixe notas para trocar por uma fonte de > pose ao vivo depois."*

*Um renderizador de pose sem câmera: landmarks estáticos alimentam um skeleton em Script SOP, útil para testar o look antes de existir fonte MediaPipe ou Kinect.* > *"Aplique `particle_system_basic`, faça o emissor subir como cinza e exponha > BirthRate, Lifetime e ForceY como os primeiros controles performáveis."*

*Um starter com Particle SOP, câmera, luz, material point-sprite e Null de saída. Simples para ensinar, completo o bastante para tocar ao vivo.* > *"Aplique `feedback_network_basic`, ajuste blur e decay para virar um túnel > recursivo de alto contraste e mantenha a rede mínima para eu aprender o loop."*

*Seed de noise, composite feedback, blur, level decay e Null de saída: a menor rede de feedback performável que ainda se comporta como instrumento visual.* > *"Aplique `glsl_shader_basic`, deixe o plasma inline editável e exponha uTime, > uScale, uColorA e uColorB para eu combinar com a paleta do show."*

*Uma receita minúscula de GLSL TOP para trabalho shader-first. Ela cai como rede válida e mantém o source perto para ensino ou remix rápido.* > *"Aplique `kinetic_text_audio_reactive`, escreva uma palavra gigante de cue e > depois ligue a expressão de brightness ao canal de grave do analyze."*

*Text TOP com cadeia transform / level ao lado de um analisador de grave. A receita deixa a expressão de áudio manual explícita em vez de escondê-la em dados inválidos.* > *"Aplique `decks_layer_mixer`, deixe os decks A e B com cores claramente > diferentes, então adicione uma nota de Cross e gain por deck para o VJ."*

*A receita de decks first-party é um esqueleto pequeno de mixer: duas fontes, dois gains, um bus composite e uma saída program estável.* > *"Aplique `depth_displacement_post`, use o depth map sintético para deformar um > ramp, então finalize com blur e level grade para parecer um post pass real."*

*Uma pilha depth/displace/post sem hardware, boa para ensaiar looks de profundidade antes de existir câmera depth ou mapa gerado.* > *"Aplique `kinetic_text_path_follow`, coloque o título do show num caminho circular > e me diga exatamente quais expressões preciso ligar depois do import."*

*Um template de ligação manual para tipo seguindo caminho: CHOPs sin/cos determinísticos guiam o movimento enquanto a receita continua válida no schema.* > *"Aplique `optical_flow_particles`, roteie o movimento da câmera para o drift das > partículas e deixe a saída pronta para um feedback de trails."*

*Vídeo ao vivo vira campo de optical-flow e empurra partículas. É a receita camera-reactive para usar quando o movimento do corpo deve deixar rastros visíveis.* > *"Aplique `atemporal_bodytrack_glitch_timeline` neste clipe vertical: comece limpo, > deixe glitches verdes curtos entrarem como bug de câmera, volte ao normal entre os > filtros e use o tracker vermelho só como pontos pequenos, linhas e rastros -- sem > círculos grandes."*

*Um template reutilizável de bug-timeline: filmagem limpa, saltos atemporais verdes, respiros normais e um branch vermelho de body tracking que parece object tracking, não decoração circular. Anime `SceneMode` para performar o edit e adicione ticks / ruído de glitch apenas enquanto um branch filtrado estiver ativo.* > *"Aplique `mediapipe_face_overlay`, escureça a webcam por baixo, tinja os pontos de > landmark e deixe o overlay fácil de trocar do demo para o adaptador de face ao > vivo."*

*Uma receita de face overlay que espelha o setup novo de face tracking: webcam, CHOP de landmarks, dots instanciados, render e composite.* > *"Aplique `scene_timeline_demo`, monte três cenas óbvias e exponha play, rate e > fade para eu demonstrar timing de cue em um minuto."*

*Um demo de três cenas guiado por timer que ensina raciocínio de show-clock sem exigir um setlist runner completo.* > *"Aplique `scene_3d_basic`, coloque uma esfera sob câmera e luz, então ligue > RotateY a uma rampa de tempo depois do import."*

*A menor cena 3D renderizável: geometria, câmera, luz, Render TOP e Null. Boa base para exercícios de material, instancing e audio-reactive.* > *"Aplique `video_synth_oscillator`, faça um synth de cor com oscilador Lissajous e > mantenha uFreqX / uFreqY / uColor expostos para ajuste ao vivo."*

*Um starter de video synth procedural, sem filmagem: um GLSL TOP desenha uma curva de oscilador brilhante com controles seguros para show.* > *"Aplique `kinetic_text_standalone`, faça a palavra respirar com LFO e deixe os > bindings pós-import documentados para um iniciante terminar."*

*Uma receita de kinetic type sem áudio para title cards, contagens regressivas e labels de cue quando audio-reactivity ainda não é necessária.* As receitas twin do v0.13 espelham ferramentas de orquestração mais novas com redes checadas por schema e validadas por live cook. Elas ficam só em texto aqui até cada vídeo ser capturado do `out1` real depois de rodar o prompt pelo tdmcp. > *"Aplique `color_grade_basic` em uma rampa de teste limpa, deixe com cara de grade > teal e âmbar de madrugada, e exponha Brightness, Gamma, Contrast, Saturation e Hue > para eu trocar por footage do venue depois."* *Uma rampa horizontal alimenta estágios Level e HSV Adjust, terminando em um `out1` estável. A receita expõe controles de grade que você pode ensaiar offline e depois trocar por uma fonte real via Select TOP. É a twin validada de `create_color_grade`, útil quando você precisa de uma cadeia de colorista antes do clip real estar pronto.* > *"Aplique `transition_dissolve`, deixe as fontes A e B obviamente diferentes, e > mantenha um controle Progress para eu ensaiar o crossfade antes de ligar decks > reais."* *Duas fontes internas se misturam por um Cross TOP com um único knob Progress de 0..1. É o menor ensaio seguro de transição A/B: suficiente para praticar o fader e depois substituir as fontes de teste por Select TOPs dos decks reais.* > *"Aplique `text_overlay_lower_third`, escreva um lower third legível para a > vocalista sobre o fundo de demo, e deixe a camada de texto fácil de trocar para o > program feed."* *Um Text TOP é composto sobre um fundo sintético e termina em `out1`. Parâmetros de texto e fonte ficam visíveis para titulação ao vivo ou binding posterior, então o overlay pode sair do lower third de demo para o program output real sem mudar a forma da receita.* > *"Aplique `layer_stack_blend`, crie três camadas de ensaio com cores e blend modes > diferentes, e exponha a opacidade de cada uma para eu praticar uma mixagem ao vivo > pequena."* *Fontes de noise, rampa e constant empilham de baixo para cima por estágios Level e Composite. A opacidade por camada fica exposta, fazendo da receita uma mini mesa de camadas legível antes de o show usar entradas reais.* > *"Aplique `strobe_flash` com uma taxa moderada de ensaio, mantenha Rate e Duty > visíveis, e me avise antes de eu subir para uma faixa insegura para > fotossensibilidade."* *Um Constant TOP pisca por um Level TOP guiado por expressão de LFO. Rate e Duty ficam performáveis, e o aviso de segurança importa porque isso é uma saída piscante real, não um preview decorativo.* > *"Aplique `test_pattern_grid`, faça uma grade de alinhamento de projetor com oito > divisões, e rotule de um jeito claro para a equipe identificar o output de longe."* *Um GLSL TOP autossuficiente desenha uma grade de calibração terminando em `out1`. Use para foco, alinhamento de mapping e checagens rápidas de output antes da arte entrar ao vivo.* > *"Aplique `datamosh_feedback_echo`, deixe o smear recursivo crescer por alguns > frames, e exponha Decay para eu tocar a trilha de codec quebrado ao vivo."* *Noise animado alimenta um loop limitado de Feedback / Composite / Level. O visual recursivo se desenvolve ao longo de vários frames processados pelo cook, então peça um preview com atraso quando for capturar o resultado.* > *"Aplique `chrome_blobs`, faça o metal líquido se mover devagar sobre um fundo > escuro de estúdio, e me diga qual binding de `uTime` eu preciso depois do import > para reflexos em movimento."* *Noise vira metaballs suavizadas e um passe GLSL de chrome. A receita é válida offline, com uma nota de binding manual de `uTime` para reflexos animados: um look reprodutível de bumper Y2K, não um shader colado uma vez.* > *"Aplique `displacement_warp_noise`, use o modulador de noise animado para fazer a > rampa ondular como miragem de calor, e deixe Amount e Speed prontos para um clip > real depois."* *Uma rampa é distorcida em UV por noise em movimento através de um Displace TOP. É um caminho seguro de ensaio offline para warps líquidos sobre footage real, com os controles ao vivo prontos antes da fonte chegar.* > *"Aplique `luma_keyer`, use a rampa como matte de luminância visível sobre um fundo > de noise em movimento, e exponha Threshold e Softness para eu ajustar uma fonte > real depois."* *Uma fonte de rampa, fundo de noise, matte por Level e Matte TOP tornam a key visível sem footage externo. É a twin de ensaio do luma key antes de uma câmera ou movie source real entrar na cadeia.* ## Generativo & abstrato > *"Crie um túnel de feedback a partir de ruído com blur e displace, adicione bloom > e me mostre um preview."*

*Uma rede de feedback de alto contraste (blur + displace + bloom), ajustada como showpiece em vez de uma demonstração técnica simples.* > *"Faça um padrão de reação-difusão em evolução, em verdes e pretos, lento e > orgânico."*

*Padrão estilo reação-difusão na GPU, com contraste mais forte e cor pronta para palco, não uma simulação de laboratório chapada.* > *"Construa uma paisagem de ruído fluida em 3D com uma câmera orbitando."*

*Um terreno 3D deslocado por ruído.* > *"Me dê um visual de atrator estranho Lorenz com partículas brilhantes no preto, > engrossado como tubo e evoluindo só enquanto a timeline toca."*

*`create_strange_attractor` integra ODEs Lorenz / Aizawa / Halvorsen num buffer rolante de Script CHOP, renderiza a trilha como geometria SOP e pode engrossar a linha com Tube SOP para virar um caminho 3D real.* > *"Me dê um visual de sintetizador de vídeo analógico dos anos 70 — padrões de > interferência suaves e scanlines rolando em verde-azulado elétrico e rosa."*

*Padrões procedurais de lissajous / interferência / scanline animados ao longo do tempo com controles de frequência e cor — uma lavagem de osciloscópio estilo Rutt-Etra autossuficiente, sem precisar de nenhuma filmagem.* > *"Construa um túnel fractal por raymarching que eu possa atravessar voando, ciano > brilhante no preto, com um botão de Velocidade."*

*Uma cena de campo de distância com sinal (SDF) renderizada inteiramente num GLSL TOP — um túnel infinito que você atravessa voando, com controles de Velocidade da câmera e de cor. Sem nós de geometria, só matemática.* > *"Construa um campo SDF programável com uma esfera subtraindo uma caixa e uma > união suave de torus, ciano-para-magenta, com controles vivos de CameraZ / > StepCount / Rotate."*

*`create_sdf_field` é o raymarcher CSG mais novo: componha primitivas esfera / caixa / torus com union, intersect, subtract e smooth blend, então performe o campo com controles SDF expostos em vez de editar shader no meio do show.* > *"Esculpa um blob de metaball macio e morfando em 3D que respira devagar, > superfície iridescente num palco escuro."*

*Uma escultura SDF estilo Shader Park (esferas e ruído mesclados) compilada num GLSL TOP, com controles de Velocidade de morph e de superfície — volumes orgânicos, tipo argila, que pulsam e se fundem.* > *"Use estas três imagens de moodboard — oceano enevoado, cobre oxidado e luz fria > de catedral — e construa um sistema generativo compatível com post-FX."*

*`moodboard_to_system` lê de 1 a 6 imagens, extrai intenção de paleta / movimento / gerador com o LLM configurado (ou fallback determinístico) e dispara um sistema Layer-1 compatível, com pós-processamento.* > *"Faça crescer um sistema orgânico de galhos a partir de um único caule, verde > musgo no preto, e deixe a taxa de crescimento reagir à música."*

*Um gerador de L-system / turtle-growth engrossado como geometria SOP renderizável, com controles de gerações, ângulo de galho, passo e espessura — útil para vinhas, raízes, circuitos e line-art viva.* > *"Empacote os seis clássicos generativos canônicos — túnel de feedback, barras de > espectro, paisagem de ruído, galáxia de partículas, reaction-diffusion e glitch de > webcam — como um bundle portátil de receitas para importar em outra máquina."*

*`generative_classics_pack` começa como uma lista read-only de receitas internas disponíveis, então pode escrever um JSON compatível com `import_recipe_bundle`. É o export rápido de "clássicos confiáveis" para workshops, instalações novas e rigs offline.* > *"Me puxe para um túnel de feedback infinito com zoom da minha webcam, deixando > rastros e girando, magenta profundo."*

*Um loop de feedback de zoom infinito dedicado (zoom + rotação + decay) semeado a partir de qualquer fonte, com botões de Zoom / Giro / Rastro — o clássico túnel de "cair dentro da tela".* > *"Preencha o quadro com uma simulação de fluido de tinta em tempo real, ciano e > magenta, com splats de áudio no bumbo mas auto-LFO quando não houver mic ligado."*

*`create_fluid_sim` constrói a pilha de advection / pressão / vorticity / dye em GLSL TOPs, expõe controles de viscosidade / dissipação / splat e consegue se autoanimar antes de você ligar uma fonte ao vivo.* > *"Transforme este poster em milhares de partículas que explodem no drop e depois > voltam como mola para formar a imagem original."*

*`image_to_particles` amostra os pixels da fonte como posições e cores de repouso, e usa um loop de partículas na GPU para a imagem dissolver, espalhar e se recompor no tempo da música.* > *"Esculpe uma catedral de esferas fundidas e anéis de toroide em pura matemática > SDF, iluminada por dentro de violeta, e me dê um botão de Camera-Z pra voar pra > dentro."*

*Um único GLSL TOP faz raymarch de uma árvore CSG (union / subtract / smooth-blend de primitivas esfera + caixa + torus) com controles ao vivo de CameraZ, StepCount, Speed, ColorA / ColorB e Background. A saída é um sólido infinitamente detalhado por onde você voa sem instanciar nenhum SOP.* > *"Monte uma paisagem 3D ondulada a partir de ruído — colinas de verdade vistas de > frente, vales em verde-musgo subindo até picos claros, um lago translúcido e calmo > cortando o relevo, e névoa de distância dissolvendo as colinas distantes no céu. > Deixe o terreno derivar devagar para nunca ficar parado, e me dê um botão de Altura > e de Zoom."* *`create_terrain` desloca um Grid SOP subdividido no eixo Z por um heightmap de Noise ao vivo num vertex MAT GLSL — geometria 2.5D de verdade, sombreada por elevação do baixo ao alto, com plano d'água translúcido opcional e fade de névoa por distância de câmera. Height / Drift / WaterLevel / Zoom ficam expostos, então é terreno deslocado real com um lago, não um plano de ruído chapado.* > *"Preencha o quadro com páginas de uma caligrafia inexistente — linhas de um > alfabeto que não existe, fluindo da esquerda para a direita como escrita de verdade, > com hastes e levantadas de caneta, desenhado como traços de tinta caligráfica limpos > sobre uma página clara."* *`create_asemic_writing` dispõe fileiras de glifos num Script SOP, cada um uma cadeia curta de traços caminhada por ruído com fluxo de baseline, hastes ascendentes / descendentes e levantadas ocasionais de caneta, tubada e renderizada ortograficamente como line-art. Nada é traçado de uma fonte — é escrita convincente num idioma que nunca foi projetado.* > *"Me dê o clássico visual Schotter — uma grade organizada de quadrados no topo que > vai ficando cada vez mais bêbada em direção à base, tombando e se espalhando. Coloque > toda essa descida ao caos em um único botão que eu possa automatizar."* *`controlled_disorder_grid` desenha uma grade rows×cols de quadrados num único GLSL TOP, onde um botão `disorder` (0 = grade perfeita → 1 = caos total) escala jitter de posição, rotação e escala por célula, cada um hasheado do índice da célula para ficar estável e reproduzível. É o "Schotter" de Georg Nees (1968) como um parâmetro ao vivo automatizável, inteiramente procedural.* ## Toolkit RayTK (SDF por node-graph) O RayTK ([t3kt/raytk](https://github.com/t3kt/raytk)) é o toolkit de raymarching / signed-distance-field da comunidade. Estes prompts constroem um **node-graph RayTK editável** (primitivas SDF → combine → material → câmera → renderer) a partir dos masters de operador (ROP) reais do RayTK — o complemento node-graph-native ao `create_raymarch_scene` em GLSL autossuficiente acima. RayTK é um pacote externo: as ferramentas exigem ele **staged + carregado** antes, e o RayTK 0.46 precisa do **TouchDesigner 2025.30770+** (fixe `build-045` para builds 2023.x). Os vídeos abaixo foram capturados de um graph vivo no TouchDesigner 2025.32820 com RayTK 0.46 carregado; num build local novo, qualquer coisa que você ainda não cozinhou ao vivo deve continuar como **UNVERIFIED-pending-td**. Sem o toolkit, as ferramentas fazem fail-forward com a mensagem "stage & load RayTK first" em vez de um render falso. > *"Verifique se meu build do TouchDesigner roda o RayTK mais recente, depois faça o > stage do toolkit para eu usar os operadores dele."* ```bash tdmcp-agent manage_packages --params '{"action":"doctor","package_id":"raytk"}' tdmcp-agent manage_packages --params '{"action":"install","package_id":"raytk","dry_run":false,"yes":true}' ``` *`manage_packages doctor raytk` lê o build ao vivo do TD e reporta o version gate (`ok` no 2025.30770+, um `warning` nomeando o build necessário caso contrário), depois `install` faz o stage do `.tox` em `~/.tdmcp/packages`. Ele nunca roda scripts de terceiros — carregue o `.tox` staged no TouchDesigner antes de construir uma cena.* > *"Construa uma cena de raymarch RayTK de verdade — uma esfera unida a um box, com > material e uma luz — como um node graph que eu posso continuar editando."* ```bash tdmcp-agent raytk-scene --params '{"sdf_primitive":"sphereSdf","union_with":"boxSdf","material":true,"add_camera":true,"add_light":true}' ```

*`create_raytk_scene` copia os masters de ROP reais do RayTK (`sphereSdf`, `boxSdf`, `simpleUnion`, `basicMat`, `pointLight`, `raymarchRender3D`) e conecta a cadeia renderizável mínima, terminando num Null TOP. Como são operadores ao vivo, você pode continuar ajustando a rede à mão depois — diferente do caminho GLSL monolítico. O renderer compila o shader numa thread em segundo plano, então o primeiro preview pode ser pré-compilação; faça um cook-wait ao vivo antes de confiar no frame.* > *"Faça um segundo estudo RayTK por node graph com um torus SDF unido a um > box-frame SDF, material magenta e uma luz, para eu inspecionar a cadeia ROP e > continuar editando os operadores."* ```bash tdmcp-agent raytk-scene --params '{"sdf_primitive":"torusSdf","union_with":"boxFrameSdf","material":true,"add_camera":true,"add_light":true}' ```

*Isto ainda é um graph RayTK, não um shader standalone: `torusSdf`, `boxFrameSdf`, `simpleUnion`, `basicMat`, `lookAtCamera`, `pointLight` e `raymarchRender3D` são copiados do pacote RayTK carregado, e o TOP final é capturado depois de um cook-wait ao vivo.* > *"Adicione um combine de smooth-union à minha cena RayTK e puxe a esfera existente > para dentro dele, para eu começar a mesclar mais formas."* ```bash tdmcp-agent raytk-op --params '{"op_type":"simpleUnion","category":"combine","parent_path":"/project1/raytk_scene_sphereSdf","connect_from":"/project1/raytk_scene_sphereSdf/sdf_primary","input_index":0}' ``` *`create_raytk_op` instancia qualquer ROP RayTK isolado pelo nome e conecta um op **existente** numa das entradas tipadas 0-based do op **novo** (origem → op novo) — aqui a esfera da cena vira a entrada 0 do `simpleUnion`. O master path, dependente da instalação, é probado ao vivo, nunca hardcoded, e chamadas repetidas se auto-posicionam à direita dos irmãos existentes. (Câmeras e luzes são ligadas direto no renderer pelos flags `add_camera` / `add_light` do `create_raytk_scene` — essa direção é op-novo → renderer, não coberta por este wire origem → op-novo.) Explore a taxonomia completa de operadores pelo recurso de catálogo `tdmcp://raytk/operators`.* > *"Construa um estudo RayTK de expression graph: esfera mais box entrando num union, > material, câmera e luz, tudo disposto como ROPs editáveis para eu continuar > expandindo a árvore SDF à mão."* ```bash tdmcp-agent raytk-expr-graph --params '{"preset":"sphere_union_box","add_material":true,"add_camera":true,"add_light":true}' ``` *`raytk_expr_graph_builder` é a superfície de graph maior: aceita presets ou `nodes` / `edges` explícitos, copia os masters RayTK necessários ao vivo, conecta índices de entrada tipados, posiciona os ROPs copiados de forma determinística e expõe o renderer selecionado por `out1`. Trate o primeiro render local como `UNVERIFIED-raytk-render` até o `.tox` do RayTK estar carregado e o shader ter cozinhado no TouchDesigner.* ## Estudos artísticos & instalações Estes prompts são para artistas visuais primeiro: loops de galeria, imagens de palco, estudos de câmera, transformações com cara de impressão e peças de instalação. > *"Faça uma murmuração de 4.000 agentes minúsculos respirando como um bando, com > botões Separation / Alignment / Cohesion para eu performar devagar."*

*`create_particle_flock` é a superfície de boids: um sistema comportamental na GPU em que a imagem não é um efeito de partículas colado por cima, mas uma multidão em movimento com regras sociais próprias. Bom para bandos, cardumes, campos de pessoas e movimento ambiente de galeria.* > *"Construa uma galáxia de partículas com curl-noise: centenas de milhares de > pontos orbitando em braços suaves, reagindo devagar ao movimento da sala."*

*`create_gpu_particle_field` é o campo de alta contagem para névoa, estrelas, cinza, plâncton e poeira. Peça `reactivity:"motion"` quando uma câmera deve energizar o drift sem transformar a peça num efeito literal de webcam.* > *"Transforme o performer num recorte preto com aro ciano/magenta e use essa > máscara para revelar um mundo generativo atrás dele."*

*`create_depth_silhouette` dá uma matte limpa para instalações: fonte sintética no ensaio, câmera/depth source no local, controles de blur/threshold/invert para ajustar a borda e uma máscara de saída pronta para composição.* > *"Rastreie quatro blobs brilhantes da câmera e deixe cada um puxar um campo de cor, > como visitantes movendo lanternas pela projeção."*

*`create_blob_reactive` transforma pontos de luz, mãos ou objetos rastreados em canais como `blob0_x`, `blob0_y` e `blob0_size`. Use em instalações participativas onde corpos controlam a obra sem ninguém segurar um controlador.* > *"Rotoscope esta fonte em linhas vetoriais fluindo: congele um frame, trace os > contornos e mantenha um botão de pulse para eu capturar um novo desenho ao vivo."*

*`create_vector_lines` é uma ponte entre vídeo e desenho: prepara uma máscara, congela, traça como geometria SOP editável e depois renderiza ou exporta. Útil para estudos de plotter, rotoscope ao vivo, testes de contorno para laser e fluxos de impressão.* > *"Faça uma tapeçaria de cellular automata, azul e âmbar, com regras que pareçam > pixels tecidos crescendo pela parede."*

*`create_generative_art` aceita `cellular_automata` como estudo promptável. Funciona especialmente bem quando o artista quer um tecido vivo, não um efeito de câmera nem um visual musical.* > *"Preencha a projeção do chão com trilhas de slime-mold: caminhos luminosos > procuram, se sobrepõem, desaparecem e deixam memória de tinta molhada."*

*`create_simulation` com `type:"slime"` entrega trilhas decaindo e movimento de busca. Fica entre reaction-diffusion e fluid sim: menos diagrama científico, mais rastro vivo.* > *"Gere uma paleta harmônica contida a partir de um tom azul-esverdeado, construa > uma faixa de gradiente e use isso como fonte de cor para o próximo visual."*

*`create_palette` não é só encanamento utilitário: é ferramenta de direção de arte. Use regras de harmonia para definir primeiro o mundo visual, depois alimente grade, partículas, cor de SDF, tipografia ou projection mapping com esses swatches.* > *"Crie traços de fitas fluindo a partir de um vector field, como caligrafia de > tinta em longa exposição se movendo sobre preto."*

*`create_generative_art` com `flow_field` é a versão promptável de movimento em linhas: boa para rastros caligráficos, mapas de corrente, desenhos de vento e estudos de movimento sem dados externos.* > *"Faça um relevo escultórico a partir de uma imagem: uma superfície iluminada de > lado que sobe e desce como peça de parede de galeria, não um filtro de vídeo plano."*

*`create_depth_displacement` transforma brilho ou profundidade em forma 2.5D real, com luz e controles de câmera orbitável. Use quando a imagem deve virar objeto.* ## Reativo a áudio > *"Construa um espectro radial que floresce no grave e solta faíscas cromáticas > nos agudos."* **O que você recebe:** uma cadeia de análise (espectro + nível + batida) alimentando um visual, geralmente com um botão de *Sensibilidade*. Veja a [nota sobre permissão de microfone](/pt/guide/troubleshooting#macos-microphone-camera-permission) no macOS, ou peça um **tom de teste** em vez do mic enquanto experimenta. > *"Construa uma bola 3D de espinhos que se projetam para fora no grave e brilham > nos agudos — mostre o preview num beat de teste."*

*Uma geometria 3D renderizada cujo deslocamento, escala e rotação são ligados a bandas de áudio ao vivo (grave / médio / agudo) com um botão de Sensibilidade — um sólido espinhento e respirante que dança com a faixa. Usa uma fonte sintética, então dá preview sem permissão do mic.* > *"Faça sidechain desta camada com o bumbo para ela abaixar e voltar pulsando a > cada batida, como um compressor."* *Um seguidor de envelope com ataque/release e gate/duck — faça sidechain da opacidade ou do brilho de uma camada com o bumbo para ela pulsar no tempo, indo além de um simples Lag de suavização. O "pump de sidechain" que todo produtor de eletrônica conhece, aplicado a um visual.* > *"Divida esta faixa em cor por classe de nota, flashes de transiente e uma > estrutura lenta de energia, então conecte cada fluxo a uma parte diferente do > visual."*

*Três caminhos novos de análise musical: `create_chroma_reactive` expõe 12 canais de classe de nota, `create_transient_reactive` separa percussão de sustain, e `create_energy_structure` detecta build / drop / breakdown com limiares adaptativos.* > *"Escute esta faixa de referência, extraia fingerprint de tempo / brilho / densidade > de ataques / dinâmica, e escolha automaticamente um sistema visual compatível."*

*`audio_fingerprint_to_visual` amostra áudio, classifica o fingerprint e dispara um gerador ajustado, como glitch, caleidoscópio, feedback, partículas na GPU ou geometria reativa a áudio. Use `dry_run` primeiro quando quiser inspecionar a escolha.* > *"Divida o feed do DJ em quatro bandas limpas, roteie sub para displacement, > médios para pulso de cor e agudos para densidade de faíscas, então conecte as > mesmas bandas ao meu GLSL TOP como uniforms `uBass`, `uMid` e `uHigh`."* *Use `create_band_router` quando uma entrada de áudio precisa virar canais de controle legíveis `band0..bandN`, depois `create_audio_glsl_uniforms` quando esses canais devem guiar uniforms do shader diretamente. O resultado não é só "reativo a áudio": é um barramento de modulação nomeado e inspecionável que quem escreve shader consegue ajustar sem reescrever GLSL a cada mudança.* ### MIDI & instrumentos > *"Faça cada nota do meu teclado MIDI disparar um estouro de cor diferente — e me > deixe testar sem plugar nada."* *Mapeia notas MIDI recebidas para canais reativos por nota (um flash ou estouro por altura), com uma fonte de notas sintética embutida, então dá preview e você pode ensaiar o look antes do equipamento estar conectado.* ## Reativo a câmera & movimento A contraparte da reatividade ao áudio — guie um visual pelo movimento ou pelo brilho na frente da sua webcam. > *"Faça um visual que reage ao movimento na frente da minha webcam, e dê > preview."* > *"Controle a quantidade de feedback pelo tanto de movimento que a câmera vê."* > *"Reaja ao brilho da sala — aumente o bloom quando acenderem as luzes."* **O que você recebe:** uma cadeia de análise expondo canais de *movimento* e *brilho* mais um botão de *Sensibilidade*. Como o mic, a câmera ao vivo dispara o [popup de permissão do macOS](/pt/guide/troubleshooting#macos-microphone-camera-permission) — ou peça uma **fonte sintética de teste** para experimentar sem câmera. > *"Analise o movimento deste clip como optical flow, suavize e use o campo vetorial > para controlar um liquid displacement warp — use o clip Mosaic embutido se minha > câmera ainda não estiver pronta."*

*`create_optical_flow` monta um campo de movimento com TOPs nativos a partir do frame atual versus o anterior, com controles de Sensitivity / Smoothing / Blur. Ele emite um TOP de flow RG-packed que pode modular displacement, partículas ou qualquer cadeia de movimento guiada por TOP.* > *"Trace minha silhueta ao vivo em um único contorno limpo — tire o preenchimento e a > cor, só o contorno em movimento do meu corpo desenhado como uma linha vetorial nítida > que me acompanha."* *`create_blob_trace` encadeia fonte → mono → blur → threshold (máscara de blob) → borda opcional → Trace SOP (máscara em polilinha) → render wireframe. O padrão é um blob sintético animado, então dá preview sem dispositivo; use `source:"camera"` para traçar a webcam ao vivo (pode pedir permissão de câmera no macOS). O blob da câmera vira line-art vetorial em movimento, não uma imagem filtrada.* > *"Faça o mouse pintar — um ponto brilhante que arrasta um rastro luminoso sobre um > campo de feedback que se dissipa, por onde eu mover o ponteiro, para eu pintar luz > com o dedo durante o show."* *`create_pointer_reactive` alimenta u/v/velocidade/botão de um Mouse In CHOP (com ganho de sensibilidade) num campo de feedback demo onde um ponto brilhante deixa rastro por cima de um buffer que decai. Os canais do ponteiro ficam expostos para ligar em qualquer outra coisa. Ponteiro único (Mouse In); multitouch real precisa de uma fonte Panel COMP, que a ferramenta reporta como aviso.* > *"Divida o quadro da câmera em alguns hotspots invisíveis e me avise quando alguém se > mexer dentro de cada um — como sensores que eu posso ligar para disparar visuais > quando as pessoas entram em partes diferentes do espaço."* *`create_interaction_zones` calcula movimento por frame (mono → diferença com o frame anterior), faz a média dentro de cada retângulo normalizado que você define e aplica threshold com dwell num canal de gatilho `zoneK_state` (0/1) por zona. O padrão é uma fonte sintética animada, então cozinha offline; uso real aponta `source_path` para um TOP de câmera. São tripwires de instalação com on/off limpo por zona.* ### Body tracking (webcam, sem hardware extra) Rastreamento de corpo inteiro por uma webcam comum, via o plugin gratuito [MediaPipe](https://github.com/torinmb/mediapipe-touchdesigner) (instale uma vez com `tdmcp install mediapipe-touchdesigner`). > *"Configure body tracking pela minha webcam e mostre o esqueleto."* > *"Faça fitas brilhantes seguirem meus pulsos e ombros, deixando rastros neon longos > enquanto eu me movo — use uma pose sintética no preview se a câmera ainda não > estiver pronta."*

> *"Controle a intensidade do visual pelo quanto meu corpo está se mexendo."* **O que você recebe:** o engine MediaPipe carregado + um adaptador que emite um CHOP de pose com 33 landmarks (tx/ty/tz/confidence), então um esqueleto ao vivo, trilhas de fita ou um visual reativo à câmera. Mantenha a timeline do TD **tocando** (o plugin captura por um browser embutido que só roda com a timeline ativa) e permita a câmera se o macOS pedir. Sem webcam agora? Peça uma fonte de pose **sintética** para montar e pré-visualizar o look offline. > *"Renderize meu body tracking como um feed ControlNet limpo estilo OpenPose: > fundo preto, membros coloridos, confidence gate e um sender NDI chamado > controlnet_pose."* *`create_pose_controlnet_driver` transforma o mesmo CHOP de 33 landmarks numa saída TOP OpenPose-COCO com controles de JointRadius, LimbThickness, ConfidenceGate e Mirror. Deixe interno para ComfyUI / StreamDiffusion local, ou publique por NDI / Syphon-Spout quando outra máquina precisar do feed de pose.* ### Face, mãos & segmentação > *"Configure MediaPipe face tracking, centralize os landmarks na ponta do nariz e > use o CHOP de face para guiar uma máscara brilhante e highlights nos olhos."*

*`setup_face_tracking` carrega o engine MediaPipe instalado e emite um CHOP com 468 landmarks (ou 478 com íris), centralizado no nariz, pronto para bind de parâmetros ou visualização de dados.* > *"Rastreie as duas mãos em coordenadas de mundo, detecte gestos de palma aberta / > pinça e conecte a altura da mão direita ao feedback amount."*

*`setup_hand_tracking` reutiliza o mesmo engine MediaPipe e emite `max_hands × 21` samples com canais tx / ty / tz / confidence / handedness. Use `coordinate_space:'world'` quando a profundidade do gesto importar.* > *"Segmente o performer da webcam, aplique feather de 4 px na máscara, publique uma > alpha matte limpa e um TOP person RGBA pré-keyado para composição."*

*`setup_segmentation` ativa o caminho de selfie-segmentation do MediaPipe e publica um Null TOP de máscara mais uma saída opcional `person_rgba`, então mattes de corpo podem alimentar keyers, silhuetas, partículas ou troca de fundo.* > *"Olha o movimento da minha câmera e empurra 20.000 partículas brilhantes com ele > — deixa rastros por onde eu me mexo."*

*Um campo vetorial de optical-flow em CPU (blur / mono / cache / composite-subtract / feedback) emite um TOP de fluxo RG-packed, que é conectado direto num campo de partículas na GPU como displacement. O resultado pinta rastros de movimento visíveis seguindo o corpo em tempo real, sem CUDA, sem hardware extra.* > *"Rastreia os pontos do meu rosto e costura uma máscara wireframe brilhante sobre > as feições, com a webcam escurecida embaixo."* *Adaptador MediaPipe ENGINE one-shot publica um CHOP de 468 landmarks (ou 478 com íris). A receita instancia pontos / linhas em cada landmark, compõe sobre uma câmera escurecida por `levelTOP` e expõe controles de Tint e Dim.* > *"Usa minha mão na câmera como um pad XY — pinça pra confirmar — e mapeia pro > Decay e Hue do visual atual."* *CHOP de 21 landmarks da mão (coordenadas de mundo) alimenta um XY pad cujo X/Y vem da ponta do indicador; a distância polegar↔indicador habilita um evento de "confirm" que trava os valores XY atuais nos parâmetros-alvo. Vira um controlador que você veste na mão.* > *"Me recorta do meu quarto com segmentação selfie e me coloca dentro de uma > nebulosa raymarched lenta, como se eu tivesse entrado num portal."* *A selfie-segmentation do MediaPipe publica uma máscara alpha limpa mais um TOP RGBA `person_rgba` pré-keyado. Composto sobre um fundo raymarched, o artista parece estar dentro da cena gerada, com bordas de matte suaves em tempo real.* ## Partículas & 3D > *"Construa um campo denso de blocos 3D instanciados que respira com uma onda de > ruído e deixa rastro neon de profundidade enquanto a câmera orbita."*

*Uma cena de geometria instanciada mais densa, com profundidade, variação de cor e movimento vivo, boa como base para áudio, câmera ou modulação de timeline.* **O que você recebe:** um sistema de partículas ou geometria com botões de *Arrasto / Turbulência / Gravidade / Vida* para moldar o movimento. > *"Mostre uma esfera metálica polida numa mesa giratória com iluminação de estúdio > realista e reflexos suaves."*

*Uma cena 3D baseada em física (material PBR + iluminação de ambiente + Render TOP) com controles de rugosidade/metalicidade e um botão de giro — um render de estúdio convincente de uma primitiva, não um cubo chapado padrão do TD.* > *"Faça uma nuvem de pontos de uma esfera flutuando devagar, pontinhos brilhantes > que cintilam, no preto profundo."*

*Um render de nuvem de pontos de uma superfície amostrada (esfera/grade/modelo) como milhares de pontos na GPU com controles de tamanho/jitter e deriva — um brilho volumétrico parecido com uma constelação.* > *"Empurre a imagem da minha webcam para um relevo 3D, onde as áreas claras saltam > em direção à câmera, iluminadas de lado."*

*Um plano deslocado em geometria 2.5D real por um mapa de profundidade/luminância via um estágio de vértice GLSL MAT, com controle de Quantidade de profundidade e iluminação — sua imagem vira um terreno esculpido e iluminado de lado.* > *"Renderize uma cena 3D com sombras de oclusão de ambiente e use a profundidade > dela para empurrar outra imagem em relevo — e eu não tenho câmera de profundidade."*

*Um render 3D multi-passe (Render + passe de SSAO) que também emite uma saída de **profundidade sintética**, que então alimenta o depth-displacement/silhueta — 3D com sombras de contato mais um mapa de profundidade fabricado por software.* > *"Adicione passes cinematográficos de pós 3D a esta cena: sombras SSAO de contato, > um pouco de SSR, profundidade de campo rasa e motion blur nos movimentos rápidos."*

*`post_passes_3d` é a cadeia dedicada para acabamento 3D com depth/normal/velocity; `apply_post_processing` redireciona pedidos de SSAO / SSR / DOF / motion-blur para ela em vez de fingir que esses passes funcionam num TOP chapado.* > *"Monte um rig de geometria estilo POP com torus, duas subdivisões, noise > displacement animado e controles ao vivo de RotateY / NoiseAmount, pronto para > renderizar."*

*`create_pop_geometry` envolve uma cadeia primitiva → transform → subdivide opcional → noise → material SOP num rig completo de render. Use quando você quer um objeto 3D editável, não apenas um shader fingindo ser geometria.* > *"Monte uma tempestade de partículas POP onde 40.000 pontos nascem de uma > nuvem-semente, atravessam um campo de força por textura e deixam um rastro > brilhante de feedback."* *`create_pop_particle_system` monta o instrumento POP renderizado: point-generator de semente, Particle POP, Feedback POP, força por lookup-texture, visualização de campo opcional e Render TOP de saída. EmissionRate, Lifetime e FeedbackGain ficam expostos para tocar a tempestade em vez de congelar o resultado.* > *"Faça crescer um organismo POP tipo coral: acreção densa para fora, movimento > guiado por ruído, decaimento lento e controles de growth rate, threshold e > feedback."* *`create_pop_growth` é o preset orgânico em POP: modos dendritic, coral e lichen com controles de GrowthRate, Decay, Threshold e FeedbackGain. Use quando o look deve parecer acreção, fungo, coral ou fibra ramificada em vez de partículas comuns.* > *"Faça uma nuvem de pontos plexus girando devagar: 1.000 pontos, conecte só > vizinhos próximos, degrade linhas pela distância e deixe pontinhos por cima."* *`create_pop_lines_pointcloud` roda um Neighbor POP sobre uma nuvem de pontos gerada ou externa, emite linhas deduplicadas via Script SOP e renderiza a teia com controles de MaxDistance, MaxNeighbors, MaxLines, Spin e PointSize. É o look plexus sem escrever o loop de vizinhança à mão.* > *"Use minha máscara de segmentação como campo de profundidade e espalhe 25.000 > pontos ao redor do meu corpo, coloridos por profundidade perto/longe e girando > devagar em 3D."*

*`create_depth_pop_field` aceita um TOP de profundidade/máscara existente ou sobe uma cadeia de segmentação, então usa lookup-texture POPs, jitter e proxy de displacement para transformar a máscara num campo espacial de pontos renderizado. DepthScale, PointSize e Spin fazem a câmera plana se comportar como volume de palco.* > *"Carregue este scan .splat como cena Gaussian Splat, conecte na minha câmera de > órbita, gere 1080p e exponha o caminho do asset e a referência da câmera no > wrapper."* *`create_gaussian_splat_scene` envolve o TDGS.tox quando ele está instalado, valida assets `.ply` / `.splat`, conecta uma câmera opcional e promove controles de SplatAssetPath, CameraRef e OutputRes. Se o TDGS estiver ausente, falha rápido com instrução de instalação em vez de travar o TouchDesigner.* > *"Estime profundidade a partir deste feed 2D de câmera, mantenha o depth map > cozinhando e use isso como fonte para um visual de relevo/displacement."* *`create_depth_from_2d` carrega o TDDepthAnything quando disponível, conecta um TOP de origem, configura modelo/resolução e devolve um Null TOP `depth_out` vivo com frame cooker. A saída pode alimentar `create_depth_pop_field`, displacement, silhuetas ou qualquer cadeia depth-aware sem câmera de profundidade.* > *"Crie um volume de nebulosa lento: 24 fatias empilhadas, paleta roxo-magenta, > alta densidade, pouca turbulência e controles ao vivo de densidade e color map."*

*`create_volumetric_field` simula volume com noise 3D animado, displacement opcional, pilha de fatias em Cache TOP e acumulação GLSL Beer-Lambert. Density, Turbulence e ColorMap transformam isso em fumaça, nebulosa, brasa, gelo, tóxico ou mono.* > *"Transforme este feed de câmera numa cidade voxel isométrica: brilho controla a > altura das torres, a cor da fonte pinta cada bloco e eu ganho controles de > HeightScale e RotateY."* *`create_voxel_stack` amostra um TOP em canais de instância, mescla barramentos de posição, altura, escala e cor, e instancia box geometry por uma câmera isométrica ou de perspectiva. É footage plano virando campo performável de cubos, não um filtro 2D pixelado.* > *"Transforme este retrato num estudo de nuvem de pontos pontilhada: pontos > quentes sobre preto, luminância controlando densidade, jitter aleatório sutil e > uma órbita lenta de câmera como uma impressão se dissolvendo no espaço."* *`create_stipple_pointcloud` converte luminância de TOP em densidade POP e renderiza milhares de pontos pequenos com controles de DotSize, JitterAmount e CameraRotate. Fica entre gravura e partículas 3D: mais tátil que halftone, mais leve que uma simulação completa de fluido ou partículas.* ## Vídeo & câmera > *"Passe minha webcam por detecção de bordas, um RGB split e um loop de feedback > para um visual glitchado."*

*O look de glitch / VHS — scanlines, RGB split e datamosh (mostrado sobre uma fonte sintética em vez de uma webcam ao vivo).* > *"Pegue minha webcam e deixe com cara de fita VHS velha e degradada."* > *"Monte dois decks de vídeo com um crossfader grande para eu misturar dois clipes > como um DJ."*

*Decks A/B mesclados por um crossfader mestre (Cross TOP) com ganho por deck; cada deck puxa uma fonte TOP ou uma fonte de teste embutida — o equivalente visual de uma mesa de DJ.* > *"Monte um mixer VJ de quatro decks: câmera, loops, camada generativa e vinheta de > logo, cada um com ganho e FX-send, mais um seletor de hard-cut para transições ao vivo."*

*`create_decks` agora tem modo N-channel: 2-8 decks, ganho por deck, FX send por deck, mix contínuo de programa e um barramento de transition-cut. Use o prompt A/B antigo para crossfader simples; use `decks[]` quando o rig já estiver parecendo um mixer VJ de verdade.* > *"Coloque waveform, RGB parade e vectorscope ao lado deste feed de câmera para eu > ajustar a grade antes da abertura do show."*

*`create_video_scopes` monta uma superfície de monitoramento estilo broadcast para uma fonte TOP: painéis de waveform, parade e vectorscope que mostram problemas de cor / exposição antes de eles virarem problema no projetor.* > *"Adicione um histogram scope de luminância a este feed de câmera com 128 bins, > escala log e traço verde-fósforo para eu enxergar pretos esmagados antes do > projetor."*

*`create_histogram_scope` transforma um TOP num painel de histograma com preview, usando uma passada GLSL de bins, normalização TOP-to-CHOP e traço renderizado. Pode rodar a partir de padrão de teste, arquivo, TOP existente ou device ao vivo.* > *"Extrai as cores dominantes do meu clipe principal e usa elas pra seedar um > color grade combinando pro resto do show."*

*`extract_palette` amostra o preview do TOP via `get_preview` e roda k-means determinístico nos pixels RGB decodificados, devolvendo swatches hex ponderados. Esses swatches alimentam diretamente alvos de lift / gamma / gain em `create_color_grade`.* > *"Transforme a câmera num espelho de IA com prompt de água etérea, mostre a > câmera crua no painel de controle e envie a saída gerada por Syphon/Spout quando > estiver pronta."* *`create_ai_mirror` envolve entrada de câmera, sintética ou TOP existente pelo StreamDiffusionTD com controles de Prompt, Negative Prompt, Strength e CFG, mais preview opcional da câmera. A saída pode ficar interna ou ir para Syphon-Spout / NDI, e a falta do TOX de StreamDiffusion vira aviso amigável com o esqueleto ainda montado.* > *"Monte meu rack de ingest ao vivo: uma fonte segura de screen-grab para ensaio, > um media bin de loops vindo de uma pasta e um chroma keyer que possa alternar > entre câmera e cartão de teste antes do show."* *`create_live_source`, `create_media_bin` e `create_keyer` são o trio prático de entrada de vídeo: um normaliza feeds ao vivo, outro varre uma pasta em clipes alternáveis e o terceiro compõe footage keyado sobre um fundo. Câmera, NDI, Syphon/Spout e streams continuam gated por plataforma/permissão, então o prompt deve pedir warnings e caminhos `out1` estáveis antes de ligar no mix do show.* ## Texto & títulos > *"Monte um hit de lyric com alpha seguro: pisque a palavra 'DROP' enorme no beat > e faça ela sumir limpa entre os golpes por cima do visual rodando."*

*`create_kinetic_text` em `mode: "flash"` cria Text TOP, LFO, gate de alpha e composite opcional por cima de um TOP de entrada. O detalhe importante para show: o texto fica transparente entre os hits em vez de piscar preto.* > *"Faça um lower third pulsando para a vocalista: nome da artista, label do palco e > um indicador pequeno de beat, composto por cima do program feed."*

*Use `create_text_overlay` para uma camada title-safe e troque para `create_kinetic_text` em `mode: "pulse"` quando o lower third deve respirar com a música em vez de ficar chapado.* > *"Crie um ticker de setlist no rodapé da saída: seção atual, próximo cue, lado do > palco e nota da artista, em loop infinito."*

*`create_text_crawl` com `mode: "crawl_horizontal"` é a camada de ticker para texto contínuo, contagens, notas de stage manager e mensagens de status de instalação.* > *"Role os créditos finais para cima sobre a cena ambiente final, com fade lento no > topo e na base do quadro."*

*A mesma ferramenta `create_text_crawl` em `mode: "roll_vertical"` resolve créditos multi-linha, statements de artista e texto de parede de galeria. Use `\n` para manter cada linha editável.* > *"Revele um manifesto curto caractere por caractere antes da instalação abrir: > 'NO PREVIEW / NO PANIC / BUILD THE LIGHT / THEN PERFORM IT'."*

*`create_text_crawl` também expõe `mode: "typewriter"` para reveals caractere a caractere. Ele está marcado como experimental na documentação da ferramenta, então use para ensaio ou docs gerados e valide a expressão do Text TOP no build de TouchDesigner alvo antes do show.* > *"Faça o nome do meu festival em letras 3D extrudadas grossas de cromo, girando > devagar com um holofote."*

*`create_text_3d` monta Text SOP -> Extrude SOP -> material -> Camera/Light/Render como uma cena de título autocontida, com controles ao vivo de Spin e Depth.* > *"Transforme a palavra 'NOISE' em geometria SOP, adicione point noise e renderize > como uma escultura tipográfica deformada em vez de um card chapado."*

*`create_pop_geometry` com `primitive: "text"` e `text_string` coloca o texto dentro do pipeline de geometria. Adicione `noise_amount` quando o título deve parecer um objeto vivo, não uma legenda.* > *"Gere um padrão de alinhamento de projetor com label OUTPUT 02 / LEFT para a > equipe identificar a superfície física de longe."*

*`create_test_pattern` consegue desenhar grids de calibração, crosshairs, números de saída e labels. Ele entra em Texto & títulos porque esses labels são a tipografia que mantém a instalação compreensível durante a montagem.* > *"Mapeie meus pads MIDI para palavras: KICK, BASS, SNARE, VOX, CLAP e PAD devem > piscar quando o canal de nota correspondente disparar."*

*Combine `create_midi_note_reactive` com `create_kinetic_text` quando a tipografia deve responder a eventos de nota individuais em vez de um nível global de áudio.* > *"Coloque o título 'DEEP FIELD' num caminho circular e deixe as letras orbitarem > ao redor do centro antes da cena principal começar."*

*Aplique a receita `kinetic_text_path_follow` quando o título precisa seguir um caminho: bugs orbitais, logos circulares de show, labels se movendo em torno de esculturas e loops de wayfinding.* > *"Transforme a palavra LUMEN em letras 3D sólidas e biseladas flutuando no escuro, > iluminadas como metal polido e girando devagar — sem geometria renderizada, só os > caracteres esculpidos na luz."* *`create_sdf_text` trata a máscara de um Text TOP como uma laje SDF extrudada e faz raymarch dela num único GLSL TOP — as letras aparecem como volumes iluminados e biselados, com profundidade ajustável e rotação opcional. Sem extrusão de mesh de fonte, sem atlas SDF externo: tipografia volumétrica saindo de uma string simples numa única passada de shader.* > *"Grave um timecode correndo no canto superior da minha saída, e me dê um modo de > contagem regressiva até zero para a abertura antes do set começar."* *`add_timecode_overlay` compõe um Text TOP cozinhando ao vivo (HH:MM:SS:FF) por cima de um TOP de entrada, com modos clock (tempo desde o início do projeto), count_up (a partir do zero) e count_down (de `target_seconds`, travado em 00:00:00:00). O FPS é sondado ao vivo — é um timecode/contagem gravado nos pixels, indispensável para ensaios e vinhetas de abertura, não só um sinal de sync.* **O que você recebe:** um kit performável de tipografia: hits de lyric com alpha, lower thirds pulsando, ticker crawls, créditos rolando, reveals typewriter, texto 3D extrudado, geometria tipográfica com noise, labels de projetor, palavras disparadas por MIDI e títulos seguindo paths. ## Performance ao vivo & controle > *"Adicione botões de feedback, zoom, giro e blur para eu tocar isto ao vivo."* > *"Anime o botão de giro com um LFO lento."* > *"Crie um relógio de tempo a 128 BPM e sincronize o movimento à batida."* > *"Faça bridge do Ableton Live para o TouchDesigner: clips, tracks, transporte e > macros de device como canais CHOP nomeados, com fallback OSC se o TDAbleton não > estiver instalado."* *`setup_tdableton` procura primeiro o componente Palette e depois cai para um OSC In simples, então o mesmo patch de show consegue ensaiar mesmo sem setup perfeito de estúdio.* > *"Monte um holograma futurista de mão: um cubo ciano transparente com scanlines > violetas flutuando acima da minha palma aberta. Comece com o preview sintético de > duas mãos, exponha controles de Size, FloatHeight, Glow e PinchScale, e faça uma > pinça da outra mão aumentar o cubo e intensificar o brilho."* *`create_hand_hologram` monta o visual completo e aninha `create_hand_gesture_bus` dentro dele. O bus estabiliza a âncora da palma, mantém a palma ativa travada quando a mão de controle entra no frame, e publica `pinch_power`, `light_gain` e `audio_level` para o mesmo tracking depois guiar lasers, partículas ou áudio.* > *"Monte um controlador de gestos pelo celular na porta 9982: X/Y multitouch para > feedback e hue, inclinação para roll da câmera e shake como gatilho de flash > seguro para panic. Me dê a URL e os nomes dos canais CHOP antes de eu fazer > bind."* *`create_phone_gesture` serve uma página local do próprio TouchDesigner e publica canais de touch, tilt, gyro e shake por Script CHOP. Sensores de movimento no iOS precisam de toque explícito de permissão no navegador e muitas vezes HTTPS, então isso entra primeiro como superfície de ensaio; só depois vira controle de show, quando as faixas dos canais já foram observadas.* > *"Transforme minhas mãos na webcam em um controlador de Ableton Auto Filter com > quatro canais via TDAbleton, sem AbletonMCP. Use rastreamento de mãos do > MediaPipe, monte um overlay de esqueleto com estrelinhas nas juntas, publique > `mapper_send` para que `map1` seja a pinça esquerda, `map2` a pinça direita, > `map3` a rotação do punho esquerdo e `map4` a rotação do punho direito, então > diagnostique o roteamento do `TDA_Mapper` antes de eu mapear os quatro slots no > Ableton."* *`create_hand_ableton_mapper` monta o lado TouchDesigner do controlador performático e `diagnose_tdableton_mapper` confere caminho do mapper, CHOP de entrada, `Reorder`, bypasses e ranges. O caminho de runtime é TouchDesigner -> `TDA_Mapper` do TDAbleton -> parâmetros mapeados de Auto Filter ou macros de rack no Ableton; AbletonMCP não é necessário.* > *"Monte um rig de ensaio de harpa de parede com Kinect em modo sintético: > 16 zonas musicais pela parede, 128 linhas laser sutis, flashes âmbar de pluck, > pontos de mão em debug e controles expostos de calibração, decay de áudio e > reverb para eu testar a peça antes de conectar o Kinect."* *`create_kinect_wall_harp` monta o instrumento de parede como um COMP no TD: linhas projetadas da harpa, saídas de debug de depth / mask / mãos, barramentos CHOP de mão e pluck, além de uma cadeia interna de áudio sine/reverb. Use `source:"synthetic"` ou mantenha `fallback_to_synthetic:true` para ensaio; só adicione vídeo no cookbook depois de capturar o `output_top` real do TouchDesigner.* > *"Monte uma camada de controle performável para este look: quatro moduladores > travados no tempo chamados breathe, shimmer, wobble e random_hold, um XY pad para > blur/hue e um look bank com slots ambient, chorus e blackout-safe mais um botão de > morph A/B."* *`create_modulators`, `create_xy_pad` e `create_look_bank` transformam um patch gerado em instrumento: modulação CHOP nomeada, controle direto em dois eixos e looks salvos que podem saltar, quantizar ou morfar. Use quando o visual já funciona e o próximo problema é repetir os controles sob pressão de show.* > *"Monte dois cues — 'intro' e 'drop' — entre os quais eu possa transicionar."* > *"Deixe eu controlar os botões principais pelo meu celular."* > *"Mapeie o primeiro fader do meu controlador MIDI para o botão de > Sensibilidade."* > *"Indo ao vivo agora — ligue o perform mode para nada engasgar no meio do show."* *`set_perform_mode` agora prefere o endpoint hardened `POST /api/perform` e devolve um snapshot tipado dizendo se o store da raiz, o perform mode da UI e o perform mode do projeto foram realmente ligados. Ainda faz fallback em bridges antigas, mas o caminho de show vira uma chamada REST real.* > *"Monte uma grade de botões estilo Ableton para eu disparar meus looks salvos ao > vivo, um toque cada."* *Uma grade de botões que disparam cues (reaproveitando o motor de recall/morph do manage_cue) — toque numa célula para pular ou morfar para uma cena salva, abrível no modo Perform como uma superfície de toque.* > *"Faça uma grade de 16 passos que dispara um strobe nas batidas fortes e um efeito > nas fracas, travada no meu tempo."* *Uma grade de passos por compasso/batida que dispara um parâmetro ou cue por passo ativo — a contraparte determinística e programável do auto-VJ; ligue e desligue passos para compor um padrão repetido travado no relógio.* > *"Monte um sequenciador probabilístico onde calm quase sempre deriva para shimmer, > shimmer às vezes salta para um estouro de glitch, e blackout só acontece em drops > raros."*

*Um sequenciador de passos Markov para estados de show: a cada batida ele amostra a tabela de transições ponderadas, emite `state` e `trigger`, e guia cues ou parâmetros sem repetir um loop fixo.* > *"Monte uma timeline de três cenas para um set a 128 BPM: intro é um túnel de > feedback, drop é uma bola de espinhos reativa ao áudio, breakdown é uma correção > de cor cinematográfica. Deixe scrubbable e mantenha os ids dos slots do setlist."*

*Uma timeline mestra de show: cenas viram blocos sobre um playhead de Timer CHOP, recalls de cue caem nas fronteiras das cenas e ferramentas seguintes conseguem manter as referências de slot do setlist em cada cena.* > *"Escaneie esta pasta de loops e monte um auto-montage quantizado na batida, que > embaralha clipes a cada compasso com meio segundo de crossfade."*

*Um seletor automático de media-bin: clipes/imagens alimentam um Switch TOP, um relógio de compasso/batida/intervalo avança o índice, e modos shuffle/random/weighted evitam deixar o mesmo clipe tempo demais.* > *"Crie um sequenciador Euclidiano com 5 batidas em 16 passos e conecte os hits a > um strobe, um estouro de glitch e a quantidade de preset-morph."*

*Ritmo estilo Bjorklund para visuais — pulsos esparsos e musicais que disparam cues, parâmetros ou scripts em vez de um metrônomo simples.* > *"Misture quatro looks salvos com um único botão Morph, com pesos para eu ficar > no meio entre neon ciano e âmbar quente durante o breakdown."*

*Um blend real entre N presets: em vez de saltar de um cue para outro, estados de parâmetros salvos viram pesos numa tabela de morph que você pode automatizar, mapear em MIDI ou guiar por uma timeline de cenas.* > *"Grave minha varredura de cutoff do filtro por quatro compassos, então faça loop > como uma automation lane para eu tirar as mãos durante o drop."*

*`create_automation_lane` amostra um parâmetro-alvo num buffer em fase com o compasso e depois toca isso de volta por um Lookup CHOP. Chame a mesma lane em modo `record` ou `loop` para armar, capturar e tocar movimentos reutilizáveis de botão.* > *"Grave meu CHOP do controlador manual por oito compassos, faça loop do melhor > take e toque de volta como fonte de modulação reutilizável."*

*`create_chop_recorder` transforma qualquer fluxo CHOP (OSC, MIDI, feature de áudio, pose ou controle customizado) numa superfície de captura / playback / loop, então um gesto ao vivo vira parte do rig em vez de sumir depois do ensaio.* > *"No compasso 32 dispare o cue do drop, no compasso 64 inicie o auto-montage e no > fim da faixa congele a saída até eu limpar."* **O que você recebe:** uma primitiva de scheduler baseada em timers/segmentos nomeados. Use para callbacks temporizados pequenos, ou coloque `create_scene_timeline` por cima quando quiser um arranjador de música scrubbable. > *"Monte um dashboard de celular com botões de cue para intro/drop/break, dois > faders mestres, uma faixa VU ao vivo e botões grandes de Blackout / Freeze para > recuperação de emergência."*

*Um cockpit único de performance servido pelo TouchDesigner: disparo de cues, faders, leitura ao vivo e controles de panic numa página para celular/laptop. Use apenas numa rede confiável.* > *"Atualize o stage dashboard para layout v2: VU estéreo, BPM vindo de > `/project1/tempo_null`, marcadores de timeline de cue vindos do meu setlist e > uma barra PANIC fixa com toque de confirmação."*

*`create_stage_dashboard` com `layout:"v2"` mantém compatibilidade com o dashboard original e adiciona leitura de front-of-house: VU estéreo, BPM, overlay de FPS / cook, faixa de timeline de cues e uma superfície de panic em duas etapas.* > *"Rode um dry-run do AI show director: permita um cue de intro de banda > pré-aprovado, coloque um pedido de fog de três segundos na fila de aprovação do > operador, e bloqueie um pedido de blackout."* *`tdmcp-agent show-director` é uma superfície de política, não um gatilho perigoso de hardware. Ele valida intents estruturadas de show, retorna decisões allow / approval / block, mantém fila de aprovação e audit log, e marca todo plano de ação como dry-run-only até um caminho humano/de operador resolver aquilo.* > *"Antes da banda entrar, arme a cena Soundcraft pré-declarada `band_a_intro` > pelo AI Show Director. Coloque na fila de aprovação, amarre o hash do catálogo e > mostre o plano dry-run sem contatar o mixer."* *`arm_mixer_scene` é separado de `arm_effect`: só um `scene_id` pré-declarado no catálogo entra na fila de aprovação, a aprovação revalida o hash do catálogo atual e o adapter dry-run devolve `hardware_changed:false`. A saída útil é o plano revisado pelo operador e o estado de auditoria, não uma ilustração decorativa de mixer.* > *"Trave o show em timecode OSC de entrada, siga a timeline quadro a quadro e pule > para cues nomeados se o rótulo de timecode disser chorus ou blackout."* *`sync_timecode` conecta MTC / LTC / OSC timecode a um CHOP normalizado e pode guiar a timeline do TD. Combine com `control_timeline_transport` para comandos explícitos de play, pause, seek, rate e cue.* > *"Agende a instalação do lobby: iniciar a cena ocean todo dia útil às 09:00, > trocar para o set dusk às 18:00 e rodar um dry-run do agendamento primeiro."* *`tdmcp-agent schedule` é o companheiro cron-lite para instalações sem operador. Ele usa agendamento por relógio de parede com timezone, pode fazer dry-run e pode disparar comandos, cues ou setlists.* > *"Grave as próximas chamadas MCP como uma macro chamada soundcheck, então rode de > novo na segunda máquina depois que a rede do palco estiver online."* *Use `macro_recorder` para capturar uma macro JSON portátil e `run_macro_script` para reproduzi-la depois. O lado CLI também consegue fazer fanout de um comando para vários agentes remotos quando várias máquinas TD precisam do mesmo setup.* > *"Planeja um set de 20 minutos atravessando minhas três cenas em modo dry-run — > me mostra o que o diretor de IA vai fazer antes de tocar em qualquer coisa."* *A camada de política do AI Show Director avalia cada chamada de ferramenta de show em modo dry-run e devolve a ação planejada + justificativa (qual cena, qual transição, quando), então o artista pré-visualiza um set autônomo antes de encostar na bridge. Aprove, edite ou rejeite antes do show rodar.* > *"Me dá um dashboard de FOH com VU estéreo, BPM ao vivo do meu detector de tempo, > overlay de FPS, faixa da próxima cue e uma barra PANIC fixa."*

*`layout:"v2"` adiciona um par VU estéreo, leitura de BPM alimentada por um Null CHOP de `detect_tempo`, overlay de FPS / cook-time / frame, faixa de timeline de cues vinda de um array de pares de `compose_cue_list` e uma barra PANIC com toque de confirmação — sem quebrar o dashboard v1 byte por byte.* > *"Pula minha timeline pra cue do refrão, coloca rate 1.25 e dá play — pelo > caminho REST rápido, não por exec de Python."* *O novo endpoint `POST /api/transport` lida com play / pause / seek / cue / rate sem `executePythonScript`. A ferramenta prefere o endpoint via `tryEndpoint` e cai para exec apenas em bridges antigas. Latência mais baixa, amigável a bridge hardenada.* > *"Adiciona uma corrente de segurança kill/dimmer na saída master com fade de > 2 segundos e um botão Emergency de pânico que eu posso apertar pelo celular."*

*`create_safety_blackout_chain` envolve o TOP de programa com um Level/dim controlado por um Null CHOP `safety_dim` (0 = aceso, 1 = preto total), um fade de 2 segundos controlado por Speed, e um toggle `Panic` exposto. Faça bind do `safety_dim` a um fader do celular com `bind_to_channel`, ou ligue um botão "dead-man" físico ao Panic. Funciona offline e é seguro instalar em uma bridge com `TDMCP_BRIDGE_ALLOW_EXEC=0`.* > *"Monta um setlist cronometrado que cicla por três cenas — intro 30s, drop 60s, > outro 45s — com crossfades de 2 segundos e um HUD mostrando agora/próximo/restante."*

*`create_setlist_runner` instala um Timer CHOP com um segmento por cena, um bus de crossfade e um Text TOP HUD lendo agora/próximo/segundos restantes. O Parameter Execute DAT `param_engine` escuta Play/Row/Skip/Prev para você sobrescrever a programação ao vivo — pausar numa cena, pular adiante ou voltar sem reescrever o timer.* > *"Envolve minha entrada NDI num watchdog que troca automaticamente pra um MP4 > pré-renderizado se a câmera cair, com crossfade de 250ms e um toggle de recuperação fixo."* *`create_show_failover` roda um Info CHOP na fonte ao vivo e observa o delta de `total_cooks` — quando ele para de subir, o watchdog roteia um Switch TOP pro MoviefileIn de backup num crossfade de 250ms. O toggle `sticky_recover` impede o ping-pong quando o NDI pisca, então o show não fica estroboscópico numa câmera instável.* > *"Liga minha pose corporal ao visual: quando eu levanto a mão direita o > caleidoscópio gira, quando eu abro os braços o bloom dobra de intensidade."*

*Encadeie `setup_body_tracking` (fonte de pose MediaPipe) em `create_pose_reactive` para obter canais CHOP nomeados por articulação e gestos derivados (`right_hand_up`, `arms_open`, `lean_left`). Mapeie esses canais para a rotação do caleidoscópio e o nível do bloom — a pose vira uma superfície de controle, sem MIDI.* > *"Cria o meu reativo, mas usa o novo gate de transiente pra palmas dispararem > um strobe, e dá um duck no bloom em cada bumbo tipo sidechain compressor."*

*`create_audio_reactive` agora aceita `transient_gate:true` (+ `transient_threshold`, `transient_hold_ms`) e `sidechain_duck:true` (+ `duck_depth`, `duck_release_ms`) para adicionar buses de gate e duck à mesma rede. Os defaults continuam desligados, então containers reativos existentes ficam byte-idênticos — opte por dentro só quando quiser os buses novos.* > *"Enfileire meus cues de strobe e logo quando eu apertar o botão, mas só dispare > no próximo limite de frase de 16 compassos para o drop cair musicalmente."* *`create_phrase_locked_cue_engine` observa um CHOP de cue pendente, coloca pulsos numa fila e trava o disparo contra um Beat CHOP local de frase. O Null CHOP de saída emite o trigger quantizado musicalmente, enquanto PhraseLength, Active, Flush e QueueDepth dão controle ao operador sobre a fila.* > *"Monte um deck de VJ inteiro e jogável de uma vez — dois decks com crossfader, > faders na tela para o crossfade e o volume de cada deck, e mapeie tudo pro meu > controlador MIDI para eu mixar na mão agora mesmo."* *`scaffold_vj_deck` compõe um mixer de decks A/B com crossfader, uma superfície de faders na tela (crossfade + ganho por deck) e uma superfície MIDI-In cujos canais já estão ligados aos mesmos parâmetros — um único container de UI cabeado e jogável. É o caminho mais rápido de "nada" até "consigo performar", com o MIDI já mapeado a partir de uma frase.* > *"Mantenha um diário do meu set — cada vez que eu fizer uma jogada grande, registre > com horário e o nome da seção, para eu ter um setlist e anotações para reler depois."* *`narrate_set` acrescenta linhas com horário (e seção + cue opcionais) a um log de sessão em markdown local (`~/.tdmcp/narration-.md`); `mode:"recall"` lê as últimas N linhas de volta. A IA deixa um setlist/diário escrito de toda a performance para você reler depois — um log append-only de decisões, não um snapshot único. Combina com o prompt `auto_vj_director`.* ## Saída & mapeamento > *"Mande o visual final para uma janela em tela cheia no meu segundo monitor."* > *"Envie isto via NDI para eu usar no OBS."* > *"Faça corner-pin disto num projetor e me deixe arrastar os cantos."*

*Uma fonte distorcida por um corner-pin (keystone) — arraste os quatro cantos para alinhar com uma parede, tela ou objeto.* > *"Grave a saída em um arquivo de vídeo por 30 segundos."* > *"Inspecione a GPU e os displays conectados, então me diga qual plano de saída é > seguro para este rig de projetores."* > *"Faça bridge deste TOP por shared memory para a máquina Unreal, e receba de volta > um fluxo CHOP de controle vindo do processo de luz."* > *"Monte uma pipeline de fixtures DMX para oito barras RGBW via Art-Net universo 1, > com canais de dimmer, cor e strobe expostos."* *`create_dmx_fixture_pipeline` organiza perfis de fixture, padding de slots DMX e um DMX Out CHOP para Art-Net ou sACN. Ele deve mostrar sobreposições, warnings acima do canal 512 e nomes exatos dos canais antes de qualquer coisa ir ao vivo; saída de fixture é hardware, então o cookbook mantém isso como relatório de roteamento/controle verificado, não como preview falso de luz.* > *"Crie um arquivo inicial de config `TDMCP_*` para este notebook de show, mas deixe > segredos comentados e recuse sobrescrever o arquivo existente sem `force`."* *`tdmcp-agent config init` imprime ou escreve toda a superfície `.env` que o servidor lê, com segredos de bridge/LLM comentados para preenchimento manual. É pequeno, mas torna o setup de máquinas de turnê repetível em vez de depender de memória oral.* **O que você recebe:** ferramentas de preparação de palco para displays, capacidade de GPU, DMX / Art-Net, IPC por shared memory e fanout multi-agente. Nesses casos de infraestrutura, a saída útil costuma ser um relatório de roteamento verificado em vez de um preview bonito. > *"Põe um scope de histograma RGB+luma estilo broadcast no canto da minha saída > pra eu ver se estou esmagando os pretos."* *Um GLSL TOP agrupa luminância e RGB por canal, normaliza por CHOPs e renderiza as barras via Script SOP + Render TOP num Null TOP pronto pra overlay. Visual de waveform-monitor de verdade, atualizando ao vivo com o seu programa.* > *"Monta um ensaio com dois projetores pra AI-Controlled Party — uma parede pro > visual principal, outra pras letras — e sincroniza ambos na mesma cue list."*

*Dois `outTOP`s conectados a dois displays físicos via `setup_output`, compartilhando um único clock de `compose_cue_list` pra que o overlay de letra vire em sincronia com as mudanças de cena. Espelha o harness de ensaio que a AI-Controlled Party usa para ensaios offline.* > *"Monte um rig de projection mapping interativo para webcam e projetor: > movimento acorda partículas ciano, cards magenta flutuam pela parede, e eu > consigo alternar entre final, câmera, movimento, blobs e calibração."*

*`create_interactive_projection_mapping` monta o rig de ensaio com fonte de câmera, sintética ou TOP existente, campo de movimento por diferença de frames, branch de blob-mask, saída de projection mapping com corner pin e switch de debug. Sensitivity, TrailDecay, BlobThreshold e ProjectionBrightness ficam expostos para calibração na sala.* > *"Envie meu TOP final como NDI chamado stage_program, mantenha inativo até eu > aprovar e também crie um sender Syphon/Spout para a máquina local de captura."*

*`create_external_io` agora inclui `ndi_out` e `syphon_spout_out` junto de OSC, MIDI, DMX, Art-Net e modos de streaming. Ele conecta o TOP de origem, define os nomes de sender/source e deixa Active desligado a menos que o prompt peça para começar a transmitir.* > *"Monte um esqueleto de facade mapping para três projetores com edge blend > horizontal, brilho por projetor, canvas de preview e curvas smoothstep."*

*`create_facade_mapping` distribui um TOP de origem em 1-8 branches de projetor, recorta cada fatia com overlap, aplica ramps de blend / branches de corner pin, cria Nulls de saída por projetor e expõe brilho mais controles de largura/curva de blend. É o esqueleto de setup antes do alinhamento físico dos projetores.* > *"Prepare testes fulldome sem hardware para este feed glitch gerado: faça um dome > master fisheye com controles de Rotation de horizonte e FOV, então monte uma cena > de teste cubemap real para eu comparar o caminho de maior fidelidade."*

*Use `create_dome_output` para uma fonte 2D equirectangular/panorâmica e `create_cubemap_dome` quando você tem, ou quer gerar, uma fonte cubemap real. Os dois produzem um dome master quadrado, mas geometria final, FOV e costuras precisam ser ajustados contra o dome ou simulador real; a saída útil é o caminho do TOP mapeado e os controles, não uma ilustração genérica de planetário.* > *"Configure algumas moving-heads que eu possa controlar via DMX, e me dê um previz 3D > para ver os feixes varrerem e mudarem de cor no palco antes de encostar no rig de > verdade."* *`create_fixture_control` monta duas metades acopladas — uma cadeia DMX-out (Constant CHOPs → Merge → Null → DMX Out, um bloco movingHead8 de 8 canais por fixture) e um previz 3D de cada cabeça com um feixe cônico cujo pan/tilt/cor seguem os valores DMX. Controle de luz DMX real e um previz de feixes ao vivo de um prompt só; a saída física precisa de interface DMX, mas o previz funciona offline.* > *"Conecte o TouchDesigner para controlar o Synesthesia via OSC — configure os > endereços exatos que ele espera, para minha análise de grave e energia irem direto > para as cenas dele sem gambiarra."* *`create_synesthesia_unreal_osc` é um preset de OSC-out nomeado (synesthesia → `/syn`, porta 6448; unreal → `/unreal`, porta 8000): um Constant CHOP com um canal por controle já nomeado com o endereço OSC exato, ligado num OSC-Out CHOP em host:porta. Basta ligar sua análise nos canais de origem — o controle cross-app "simplesmente funciona" porque os templates de endereço já vêm preenchidos, sem digitar endereço à mão.* > *"Antes de abrir a casa, me dê um relatório pre-show de `/project1/show`: status > da bridge, erros de nós, topologia, orçamento de performance e prontidão de > displays; se estiver limpo, monte uma companion surface para os controles do hero."* *`show_preflight_report` fica read-only e devolve PASS/UNVERIFIED/WARN/FAIL em vez de um visual. `create_companion_surface` então embrulha um COMP escolhido com controles gerados, faders/cues e o mesmo contexto de preflight, para o operador receber uma superfície tocável mais os checks que explicam se ela está pronta para uso.* > *"Monte o roteamento da sala de controle: uma matriz OSC para Resolume e VDMX, > uma bridge de cues para QLab, controles de cut/auto do ATEM via Companion e botões > de cena/gravação do OBS, mas deixe credencial e disparo ao vivo sempre explícitos."* *`osc_router_matrix`, `resolume_vdmx_output_chain`, `qlab_osc_bridge`, `atem_switcher_control` e `obs_stream_control` criam lanes de controle e notas. São scaffolds para softwares externos reais: valide host/porta/auth na sala antes de tratar qualquer botão como live.* > *"Prepare playback e handoff de saída: um transport de movie/audio com Play, Loop > e Speed, um loop de edição de shader para correções GLSL de última hora e um preset > ProRes de review quando o look for aprovado."* *`clip_audio_transport` constrói o player seguro para ensaio, `edit_shader_live_loop` edita um GLSL/Text DAT e logo inspeciona erros e preview opcional, e `export_render_preset` envolve `record_movie` com presets nomeados para review, HAP, ProRes e handoff estilo NotchLC.* > *"Prepare os scaffolds de calibração do venue: dois lanes de projetor com corner-pin > e level, mais um tracker LiDAR sintético de chão para eu ensaiar zonas antes do > sensor real chegar."* *`projector_calibration_wizard` e `lidar_floor_tracker` separam de propósito scaffold offline de verdade física. O graph pode ser construído e inspecionado agora; alinhamento de projetor e tracking de sensor real continuam `UNVERIFIED` até validação nas saídas e hardwares reais.* > *"Importe esta cena Blender para um scaffold de render PBR e coloque ao lado uma > bridge guardada de Notch / TouchEngine, para eu testar asset e engine em tempo real > no mesmo projeto de ensaio."* *`blender_scene_import` cria um scaffold PBR no TD ao redor de um caminho de asset adjacente ao `.blend`, ou uma primitiva fallback. `notch_touchengine_bridge` adiciona o placeholder guardado de Notch TOP / Engine COMP e notas; licença/runtime continuam passo ao vivo do operador, não algo que o cookbook possa fingir.* ## Consertar & entender > *"Algo parece quebrado — confira a rede em busca de erros e conserte."* > *"Pegue um inline preview de `/project1/out1`: me dê um thumbnail de 256 px, > metadados de cook, parâmetros alterados e erros dos pais numa resposta > estruturada."*

*`get_inline_preview` é a passada compacta de inspeção para agentes: uma chamada retorna thumbnail limitado, resolução / formato de pixel / stats de cook, parâmetros alterados e uma varredura de erros nos pais sem encadear várias ferramentas de preview e erro.* > *"Explique o que esta rede está fazendo, passo a passo."* > *"Leia os modos de parâmetro de todos os nós importantes em `/project1/hero` > numa chamada batch, então me diga quais parâmetros são expressão, bind ou canal > exportado."* *O caminho `POST /api/param_modes/batch` da bridge deixa agentes inspecionarem modos expression, bind, export e constant de muitos nós em uma rodada só. Ele substitui o loop antigo de vários execs quando você precisa entender por que um rig está reagindo, travado ou sobrescrito.* > *"Isto está lento — ache o gargalo e otimize."* > *"Pontue este build em paleta, movimento, complexidade, erros e performance, então > sugira as menores mudanças que melhorariam o resultado."* *`score_build` é read-only e devolve uma rubrica de 0 a 100 com sugestões determinísticas. `enhance_build` pode pré-visualizar ou aplicar um pequeno ciclo de melhoria permitido, então pontuar de novo para mostrar se a intervenção ajudou.* > *"Extraia as cinco cores dominantes de `/project1/look/out1` e use-as como > swatches para a próxima paleta e correção de cor."*

*`extract_palette` captura um preview TOP e roda k-means determinístico nos pixels. É read-only, então é seguro para ciclos de crítica, hand-off de paleta e prompts do tipo "faça o próximo look combinar com este".* > *"Pergunte ao vision copilot o que domina este TOP, se o assunto é legível do fundo > da sala e qual única mudança mais melhoraria o resultado."* *`copilot_vision` envia um TOP renderizado mais a sua pergunta ao LLM multimodal configurado. Ele complementa ferramentas determinísticas como `caption_top` e `score_build` quando você quer resposta de direção de arte, não só medições.* > *"Eu sei que quero `create_audio_reactive`, mas só disse 'barras neon do microfone' > — infira os argumentos obrigatórios ausentes pelo schema e mostre a chamada > proposta."* *`elicit_missing_args` usa o schema registrado da ferramenta mais o contexto da conversa para propor apenas os campos ausentes. É read-only e ajuda agentes a fazerem menos perguntas manuais sem inventar parâmetros inexistentes.* > *"Faça profile de cook cost por 60 frames e ranqueie os nós com maior chance de > causar queda de frame."* > *"Arrume o layout para eu conseguir ler."* > *"Troque este `noiseTOP` por um `rampTOP`, mantenha o nome e os fios, preserve os > parâmetros compatíveis e relate o que não pôde ser carregado."* *`swap_operator` é a versão cuidadosa de "substitua este nó": ele tira snapshot dos fios e parâmetros, recria o tipo de operador no mesmo lugar, reconecta o que consegue e devolve parâmetros descartados/falhas explicitamente.* > *"Tenta consertar essa cadeia de render quebrada — mas se a contagem de erros > aumentar, desfaça toda mudança que você fez."* *O loop de repair agora tira snapshot de `(par.path, par.mode)` e `(op.path, op.bypass, op.display)` antes de cada passo. Se `errors_after >= errors_before` e não for dry-run, todo passo aplicado é revertido e o relatório carrega uma flag `rolled_back: true` — o agente não consegue piorar a situação. Uma passada de reparo que se desfaz sozinha, a rede de segurança que todo artista queria do "AI, conserta aí".* > *"Roda um auto-repair em `/project1` — até três passadas, para se os erros > pararem de cair e desfaz qualquer passada que piore o estado."* *`auto_repair_loop` é o verbo "conserta tudo": ele dirige `repair_network` em iterações, marca `errors_before`/`errors_after` por passada, para no platô e herda o mesmo rollback de segurança. Uma chamada no lugar do ciclo manual reparar/checar/repetir.* > *"Antes de tocar neste patch de show, amostre `/project1/out1` num grid 8x8 e > me diga se ele está vivo, quais cores aparecem por alto e se vale gastar uma > captura completa."* *`get_preview` com `sample_grid` devolve um grid de amostras RGBA mais estatísticas min/max/mean por canal em JSON, sem codificar imagem. Use como checagem barata de "este TOP está vivo?" antes de gastar contexto com preview completo ou crítica.*

*Capturado ao vivo do TOP `/project1/cookbook_ops_demo/sample_grid_halftone_source/out1` amostrado com `sample_grid:8`. O clipe mostra o output do TouchDesigner sendo amostrado; a resposta real da ferramenta é o grid RGBA e as estatísticas em JSON.* > *"Dispare o reset de `/project1/trails/feedback1`, espere 12 frames e depois > colete o preview para eu ver o burst depois que o feedback loop estabilizar."* *`get_preview` agora aceita `pre_pulses` e `delay_frames`: pulsa um ou mais parâmetros no mesmo frame, adia a captura e depois coleta por `job_id`. É para looks transitórios que somem se você capturar um frame cedo demais.*

*Capturado ao vivo do TOP `/project1/cookbook_ops_demo/preview_burst/out1` depois de disparar `reset` em `/project1/cookbook_ops_demo/preview_burst/feedback1` e esperar 12 frames pelo tdmcp. Este clipe é o resultado do TouchDesigner, não uma ilustração do prompt.* > *"Antes de setar o device de entrada em `/project1/live_in/moviefilein1`, leia > os valores de menu e me mostre os nomes de máquina exatos que posso usar sem o > TouchDesigner escolher silenciosamente o primeiro item."* *`get_parameter_menu` busca ao vivo `menuNames`, `menuLabels` e o valor atual do menu no build de TouchDesigner rodando. Peça isso antes de setar parâmetros Menu / StrMenu; se raw exec estiver desligado, o fallback vem marcado como catálogo embutido possivelmente defasado.* > *"Leia as linhas 500-560 de `/project1/show/state_table`, inclua o header e as > cinco primeiras linhas, e me diga se algum estado de cue parece errado."* *`get_dat_content` lê Text DATs e Table DATs em páginas: `offset`, `limit`, `include_header` e `preview_rows` impedem uma tabela enorme de cues de inundar o modelo. O resultado inclui contagem de linhas, estado de truncamento e a janela exata lida.* > *"Depois de montar o hero look, foque o Network Editor no novo output, no painel > de controle e no composite final para eu inspecionar os nós exatos sem caçar na > rede."* *`focus_network_editor` é um movimento de UI: ele faz pan/zoom no Network Editor do TouchDesigner para enquadrar os operadores selecionados e não muda nada no grafo. É o passo de handoff depois de um build gerado, não um efeito visual.* > *"Arrume `/project1/hero` recursivamente, mas mantenha todo DAT de shader > dockado junto do nó a que pertence."* *`arrange_network` mantém a limpeza left-to-right do fluxo de dados, e `include_docked` agora move DATs dockados de GLSL / callbacks pelo mesmo delta do nó dono. Use quando a rede gerada só fica legível se os DATs auxiliares viajarem junto.* > *"Desative `/project1/hero/old_grade` para o ensaio, mas não delete — quero > poder reativar se o diretor sentir falta daquele look."* *`delete_td_node` com `mode:"bypass"` liga o bypass do operador em vez de destruir o nó. É o meio-termo reversível entre deixar um operador quebrado na cadeia e apagar trabalho de show permanentemente.* > *"Reconstrua esta pequena cadeia de post a partir do spec salvo com auto-layout > ligado, para os reruns não deixarem nós empilhados e os fios ficarem legíveis da > esquerda para a direita."* *`rebuild_network` com `auto_layout:true` calcula posições a partir do grafo de inputs do spec e sobrescreve coordenadas manuais velhas antes de criar os nós. É útil para round-trips de receita/spec em que a rede correta ainda precisa ficar legível no layout do TD.* > *"Antes de eu construir, me diga quais operadores existem de fato no TouchDesigner que > estou rodando agora — sinalize qualquer coisa documentada que esta versão não > consegue criar."* *`check_operator_availability` reconcilia a base de conhecimento de operadores com a lista real de optypes criáveis no TD que está rodando, sinalizando ops descontinuados ou indisponíveis (e, opcionalmente, optypes ao vivo ainda não documentados). Pega o "esse nó não existe no meu build" antes de o build falhar — verdade de campo da instalação viva, não uma lista estática. Sobrevive a `TDMCP_BRIDGE_ALLOW_EXEC=0`.* > *"Fique de olho nos parâmetros deste nó e me avise sempre que um valor mudar — seja eu > movendo à mão ou um script — para eu ver o que está mexendo no meu patch ao vivo."* *`watch_parameter_changes` assina eventos `param.changed` dos parâmetros de um operador; cada mudança transmite `{path, par, prev, value, frame}` ao cliente como notificação de logging (coalescida para o arrasto de um slider não inundar). Telemetria ao vivo de "quem mexeu no meu parâmetro", seja mão ou script. Requer o stream de eventos do TD (`TDMCP_EVENTS`) ligado.* ## Looks reutilizáveis & handoff de show Use estes quando o look já funciona e você quer tocar de novo, ensinar, levar para outra sala ou transformar em saída física. > *"Deixe este hero look pronto para turnê: exponha controles Speed, Palette, Glow e > Reset, coloque labels claros, salve como `.tox` portátil e inclua uma imagem de > preview para eu reconhecer antes de abrir o TouchDesigner."* *As ferramentas de pacote ajudam quando servem ao artista: `.tox` portátil, controles visíveis, notas simples e thumbnail da saída real. O resultado é um instrumento visual para colocar no show, não um exercício de handoff técnico.* > *"Transforme `/project1/hero_look` num starter de workshop: preserve a rede visual, > capture os controles que eu devo explicar e deixe fácil aplicar em um projeto > vazio na semana que vem."* *`scaffold_recipe_from_network` pode transformar uma subárvore TD pronta numa receita reaplicável. Para artista, a utilidade é ensino e ensaio repetíveis: reconstruir o look do zero e ajustar os controles expostos na frente das pessoas.* > *"Faça um mapa de uma página deste patch: thumbnail da saída final, os três > controles que devo tocar ao vivo e um diagrama simples da esquerda para a direita > mostrando como o sinal vira imagem."* *Notas geradas só entram aqui quando parecem mapa de estúdio: o que é o look, quais controles importam, o que alimenta a saída e como está o preview atual.* > *"Salve este look com três variantes — ambient lenta, refrão de alta energia e > blackout-safe — e marque a favorita para eu encontrar rápido no próximo ensaio."* *Tags, variantes e notas de versão no vault ajudam artistas a manter uma biblioteca ao vivo organizada: a pergunta vira "qual look eu confio para este cue?", não "qual arquivo eu exportei mês passado?"* > *"Monte uma cadeia de controle de grave chamada `bass_energy`, `bass_peak` e > `bass_gate`, depois me mostre onde ligar brightness, blur e pulse no visual > atual."*

*Builders Layer-2 ficam artist-facing quando produzem fontes de modulação limpas, com nomes legíveis. Você ganha canais estáveis para performar, enquanto os detalhes CHOP continuam editáveis quando quiser aprender.* > *"Exporte esta escultura generativa de linhas como SVG de polilinhas para meu > AxiDraw, mantendo a escala e orientação do preview para o plot parecer a versão > da tela."*

*`export_sop_to_svg` lê primitivas SOP e escreve vetores prontos para plotter. É a ponte da imagem generativa ao vivo para canetas, lasers e impressão.* > *"Empacote este componente para eu levar ao laptop do local sem nada faltando — copie > cada vídeo, fonte e LUT que ele usa para junto dele, reaponte tudo, e salve como uma > pasta portátil única."* *`bundle_dependencies` varre um COMP recursivamente atrás de referências externas, copia cada asset para `/assets/`, reescreve os parâmetros ao vivo para as cópias relativas e salva um `.tox` + manifesto — uma pasta movível, sem links quebrados. É o "collect + relink + save" de verdade num passo (ao contrário do `make_portable_tox`, que deixa os assets para trás); use `rewrite_refs:false` para copiar sem tocar na rede ao vivo.* > *"Salve este componente como uma árvore versionável para meu projeto mostrar diffs > reais por nó no git em vez de um blob binário opaco."* *`export_externalized_tree` usa `COMP.saveExternalTox` para escrever o componente (e, com recurse, cada COMP descendente) como seu próprio `.tox` em disco com `externaltox` reapontado — diffs por nó sob controle de versão. Transforma um projeto TD em algo que o git consegue de fato diffar, em vez de um blob binário opaco.* ## Autoria de shader & material > *"Crie um material GLSL para esta esfera: faixas iridescentes tipo óleo, rim light > suave e um uniform `uTime` que eu possa guiar pela timeline."*

*`create_glsl_material` cria o GLSL MAT mais os Text DATs auxiliares, conecta os shaders de pixel/vértice e avisa sobre armadilhas de GLSL no TouchDesigner, como `fragColor` ausente, colisões com o preâmbulo F1/F2 e `uTime` não declarado.* > *"Importe este sketch do Shadertoy, conecte placeholders nos iChannels se precisar, > exponha controles de Speed e Mouse, e faça preview do GLSL TOP traduzido."*

*`import_shadertoy` mapeia `iTime`, `iResolution`, `iMouse` e `iChannelN` para uniforms / entradas TOP amigáveis ao TouchDesigner. Cole `raw_source` quando quiser manter a importação inteira offline.* > *"Importe este shader ISF, gere uma página limpa de parâmetros customizados a partir > dos INPUTS e mantenha o GLSL editável no TouchDesigner."*

*`import_isf_shader` parseia o cabeçalho JSON do ISF e transforma entradas float / color / bool / event / long em controles TouchDesigner, então sketches de biblioteca viram redes tocáveis em vez de blocos de código colados.* > *"Me dê um material que faça qualquer malha ondular e inchar na GPU — empurre cada > vértice pela normal com ruído 3D em movimento, para uma esfera simples virar uma bolha > derretida e agitada que eu possa aplicar na minha própria geometria."* *`create_vertex_displacement_mat` cria um GLSL MAT cujo estágio de vértice desloca cada vértice pela normal com ruído 3D procedural (ou pela luminância de um TOP amostrado), atribuído a um Geometry COMP alvo — deformação física de mesh na GPU. Sem alvo ele monta uma esfera demo para o material dar preview sozinho. Diferente dos warps de pixel 2D (`create_displacement_warp` / `create_depth_displacement`): aqui a malha real ondula e incha, e você aplica na sua própria geometria.* > *"Transforme este sketch de GLSL TOP num material no logo 3D, exponha Color, Speed > e Fresnel, depois renderize um preview."* **O que você recebe:** uma etapa de autoria de shader que mantém o código editável em DATs enquanto transforma os uniforms importantes em controles tocáveis no TouchDesigner. ## Efeitos e looks marcantes > *"Dobre minha webcam num caleidoscópio de seis lados girando devagar, em tons de > joia profundos, e me mostre um preview."*

*Um espelho de dobra polar em GLSL ao vivo transforma qualquer fonte numa mandala simétrica; expõe os Segmentos e um botão de rotação/Velocidade. Apontado para a webcam, faz a sala desabrochar em pétalas caleidoscópicas.* > *"Faça meu vídeo parecer um arquivo corrompido que borra e derrete a cada corte > seco — datamosh pesado."*

*Um borrão de deslocamento de pixels guiado por feedback que sangra vetores de movimento entre quadros, com controles de Quantidade/Decay — o clássico look de "codec quebrado" que floresce e derrete, numa fonte de teste padrão (troque pelo seu clipe).* > *"Transforme isto em pontos de meio-tom âmbar quentes, como impressão de jornal > antigo, e mostre o preview."*

*Uma tela de meio-tom em GLSL converte a imagem numa grade de pontos de tinta cujo tamanho acompanha o brilho; expõe a escala dos pontos / Ângulo / matiz. O tom âmbar mais o fundo branco-papel dão uma sensação de impressão retrô.* > *"Deixe esta fonte como um sonho febril de Game Boy: dither ordenado de 4 cores, > pixels crocantes, threshold animado e controle Mix ao vivo."*

*`create_dither` monta dither Bayer / checker / noise / error-diffusion com quantização mono, duotone ou RGB. É um look, não só um filtro utilitário.* > *"Gere um campo Voronoi de vitral com sementes animadas, linhas escuras grossas e > controles de paleta para Color A / Color B."*

*`create_jfa_voronoi` usa uma cadeia Jump-Flooding (seed init, passes por metade, color pass) para criar mosaicos / vitrais animados com controles ao vivo de sementes e bordas.* > *"Distorça esta filmagem com uma distorção líquida fluida que ondula como calor > sobre o quadro inteiro."*

*Guia um Displace TOP a partir de um campo de ruído animado, então a fonte ondula e flui, com controles de Quantidade/Velocidade — uma distorção de calor / submersa sobre qualquer entrada.* > *"Transforme este feed de câmera em linhas de tinta fluindo, como um frame de > videoclipe desenhado com edge tangent flow e carvão animado."*

*`create_flow_abstraction` monta o caminho ETF / FDoG painterly: fluxo coerente de linhas em vez de bordas Sobel simples, bom para looks de quadrinho, tinta e câmera gravada em metal.* > *"Dê a este shot um filtro Kuwahara de pintura a óleo, e me deixe alternar entre > oil, pencil e watercolor durante o set."*

*`create_npr_filter` expõe o look não-fotorrealista como componente controlável; `apply_post_processing` também entende `npr_oil`, `npr_pencil` e `npr_watercolor` para cadeias rápidas.* > *"Dê a isto uma correção de cor cinematográfica teal-and-orange — afunde um pouco > os pretos e levante as altas-luzes."*

*Uma correção de lift/gamma/gain + saturação/matiz (com LUT opcional) sobre qualquer fonte, expondo as rodas como botões — o look teal/laranja de Hollywood como uma camada de finalização.* > *"Dê a esta câmera uma correção de três rodas de verdade: sombras frias, altas-luzes > quentes, um pequeno black offset e controles ao vivo de Lift/Gamma/Gain por canal."*

*`create_color_wheels` monta a superfície clássica de colorista: três Level TOPs tingidos para sombras/médios/altas, offset preto master e saturação. Use quando sliders simples de grade não forem expressivos o bastante.* > *"Aplique este LUT .cube ao feed de câmera, mostre um split antes/depois e caia > para GLSL se OCIO não estiver disponível."*

*`apply_lut` escolhe a melhor rota disponível: OCIO quando existe, lookup por imagem para previews de LUT, ou fallback GLSL a partir de `.cube` parseado quando a máquina está sem dependências extras.* > *"Quando eu mover este slider, faça um corte com glitch do primeiro clipe para o > segundo, com um estouro de ruído digital."*

*Uma transição A→B sobre um único botão de Progresso de 0–1 com estilos selecionáveis (dissolve / luma_wipe / slide / zoom / glitch_cut) — arraste o fader para fazer um wipe entre duas fontes no meio do show.* > *"Renderize minha câmera como ASCII verde-fósforo brilhante, com cor da fonte nas > áreas claras e um botão Mix para voltar ao original."*

*`create_ascii_render` reduz a fonte para células, cria um atlas de glifos em Text TOP e renderiza uma grade de caracteres em GLSL. Os modos mono, source-color e two-color cobrem terminal fósforo, câmera posterizada e palco duotone.* > *"Faça um slit-scan vertical da dançarina: cada linha deve ser um momento > diferente no tempo, 120 frames de profundidade, subindo como fitas de tempo."* *`create_slit_scan` grava a fonte num ring buffer de Cache TOP e amostra isso em GLSL para que cada linha ou coluna venha de um frame passado diferente. O controle Depth define quanto tempo é esticado pela saída.* > *"Dê a este feed glitch gerado um time echo: rastros fantasmas recursivos em modo > echo no verso, depois um derretimento time-displace guiado por ramp vertical no > breakdown."*

*`create_time_echo` é o container mais amplo de efeitos de tempo: `echo` para trails recursivos por feedback, `slit_scan` para fatias de tempo por linha/coluna e `time_displace` para offsets de frame por pixel guiados por ramp ou noise TOP. Peça resolução fixa e warnings porque nomes de operador cache/time-machine variam entre builds do TD.* > *"Gere blobs de cromo líquido num fundo preto de estúdio, metal azulado, > movimento lento e controle de Speed para aquele momento de logo Y2K."*

*`create_chrome_blobs` transforma noise animado em metaballs borrados/thresholded e sombreia tudo com um passe GLSL de chrome por environment-map falso. Tints de metal e presets de fundo tornam isso útil como vinheta de logo, não só teste de textura.* > *"Crie um look Gray-Scott de reaction-diffusion com cores coral, manchas tipo > labirinto e controles ao vivo de Feed/Kill/Diffusion para morph biológico lento."*

*`create_reaction_diffusion` parte da receita Gray-Scott incluída, corrige os uniforms GLSL de Feed/Kill/Diffusion A/B, aplica opcionalmente um ramp de LUT e expõe os parâmetros químicos como controles performáveis.* > *"Pixel-sort este feed ao vivo em rastros verticais de chuva: ordene por > luminância acima do threshold, descendente, 96 iterações, com Mix em 0.8."* *`create_pixel_sort` usa um loop GLSL de odd-even sort com Feedback TOP, Switch TOP e máscara de threshold. Axis, SortBy, Direction, Threshold, Iterations e Mix ficam ao vivo para ajustar o smear estilo Asendorf em vez de colar um shader uma vez.* > *"Pegue meu clipe e o estilhace numa parede de vídeo 5×5 dele mesmo, cada bloco > levemente deslocado e trepidando, para respirar como uma folha de contato > caleidoscópica."* *`create_step_repeat` ladrilha um TOP de origem numa grade rows×cols com gap ajustável e jitter de posição por célula. O padrão é uma fonte Noise sintética, então dá preview sozinho; aponte `source_path` para qualquer TOP e multiplique um clipe ao vivo numa parede de vídeo estilo folha de contato, com trepidação orgânica célula a célula — um staple de VJ numa chamada só.* ## Mixagem e camadas > *"Empilhe quatro camadas com modos de mistura e opacidade, cada uma com mute e > solo, para eu mixar um look na hora."*

*Um compositor de N camadas com modo de mistura + opacidade + mute/solo por camada e uma faixa de controle gerada — uma pilha de camadas estilo Photoshop/After Effects que você pode tocar.* > *"Monta um rig de quatro decks com FX sends por deck pra um bus de retorno > compartilhado e um switch de hard cut que eu posso mesclar de volta."*

*O modo `decks[]` monta rigs de 2 a 8 decks com ganho por deck, branches de FX-send por deck num bus / retorno aditivo, um mix de programa contínuo via Cross TOP e um hard-cut Switch TOP mesclado de volta no programa com `cut_mix`. O mixer A/B antigo continua compatível.* ## Visuais orientados a dados > *"Puxe o preço do BTC ao vivo de uma API web e controle a cor e a velocidade do > visual pela rapidez com que ele se move."*

*O create_data_source puxa um feed JSON/web ao vivo para canais CHOP; o create_data_reactive mapeia esses canais nos parâmetros de um visual com remapeamento de faixa por mapeamento — a contraparte de dados da reatividade ao áudio.* > *"Prototipe um dashboard visual guiado por WebSocket a partir deste stream de > eventos, mas rode em modo dry-run / experimental primeiro e relate erros de bridge > antes de ligar no show."*

*`create_data_source_http_ws` é a ponte HTTP/WebSocket para transformar seletores JSON em canais CHOP. O corte público v0.7.0 inclui o hotfix de HTTP-poll, então o prompt já pode pedir status, seletores, nomes de canais e warnings como parte do relatório de build.* > *"Transforme esta planilha de vendas mensais em barras 3D animadas que crescem, com > rótulos de valor."*

*Uma rede de visualização orientada a dados (barras/gráfico a partir de uma tabela) com um botão de Escala e uma entrada animada — um infográfico em tempo real e tocável, não um gráfico estático.* > *"Clone este cartãozinho uma vez por linha da minha tabela, cada um com o nome > daquela linha."*

*Um Replicator COMP que clona um COMP de template por linha de um Table DAT, parametrizando cada clone a partir da sua linha — instanciamento orientado a dados de sub-redes inteiras, não só de geometria.* > *"Monte uma cadeia LLM offline com Ollama dentro do TouchDesigner: prompt DAT > entrando, response DAT saindo, botão Send exposto e JSON mode pronto para notas > de cue."*

*`create_llm_chain` cria um wrapper LLM baseado em webclientDAT para Ollama, OpenAI, Anthropic ou endpoint custom compatível com OpenAI. Prompt e Response DATs, canal de status e controles de provider/model/temperature/max-token ficam dentro do TD, enquanto as chaves de API são lidas por variáveis de ambiente e nunca aparecem via Node.* > *"Pegue este GeoJSON de um bairro e levante-o numa pequena cidade 3D — extrude cada > silhueta de prédio pela altura no dado, disponha as ruas como fitas, e enquadre com > uma câmera para parecer uma maquete que eu possa iluminar."* *`create_geo_visualization` parseia uma FeatureCollection GeoJSON (Point/Line/Polygon), constrói a geometria num Script SOP, extruda cada feature de polígono/linha pela propriedade `height` do próprio dado e envolve tudo num Geometry COMP sob um Render TOP com câmera e luz. Dados de mapa reais viram uma maquete 3D iluminada de um prompt só; precisa de um payload GeoJSON e usa `height`/`default_height` de cada feature para a extrusão.* > *"Faça meus visuais reagirem a quantas pessoas a câmera vê — puxe contagens e posições > de objetos do meu detector e exponha como canais que eu possa mapear para intensidade > e taxa de emissão."* *`create_detection_reactive` assina um detector externo por WebSocket (JSON `{count, objects:[{x,y,w,h,score}]}`) ou monta um Script CHOP ONNX em CPU, expondo contagem e posições de detecção como canais CHOP para guiar qualquer parâmetro. Detecção de objetos (pessoas, mãos, props) dirigindo visuais sem CUDA — o caminho WebSocket roda em qualquer lugar; precisa de um processo detector externo ou de um modelo ONNX seu.* ## Checagens de ensaio & feedback artístico Use estes quando quiser que o tdmcp teste o trabalho como um artista testaria: consigo ver, consigo tocar, reage direito e é seguro continuar ensaiando? > *"Antes do ensaio, abra meu output principal, tire um snapshot rápido do preview e > me diga se está preto, em baixa resolução, congelado ou com erro."* *`get_inline_preview` transforma "isso está vivo?" em uma checagem: thumbnail, resolução, formato de pixel, metadados de cook e erros recentes. A resposta deve vir primeiro como imagem e linguagem simples.* > *"Observe o analyze CHOP do grave por cinco segundos e me diga o min/max real para > eu ajustar a faixa do visual antes do DJ chegar."* *`watch_node` é útil quando lê um sinal do jeito que performer precisa: faixa real, picos, momentos quietos e se o canal está estável o bastante para ligar num look.* > *"Cheque o perfil de venue `club` sem mostrar segredos: o TouchDesigner está > alcançável, a bridge está na porta esperada e o que eu preciso corrigir antes da > abertura da casa?"* *Checagem de venue/perfil só pertence ao cookbook quando responde uma pergunta de show: para qual sala estou configurado, a bridge ao vivo responde e qual ação concreta mantém o ensaio andando?* > *"Leia o mapa compacto de `/project1/hero` e explique os controles visíveis em > linguagem simples: o que muda cor, movimento, intensidade e reset?"* *`compact_graph_digest` resume uma rede sem afogar o artista em nós: contagens, fios e parâmetros-chave viram um mapa curto do que o look sabe fazer.* > *"Durante o soundcheck, escute eventos de beat e onset por dez segundos e me diga > se o fluxo de cues está estável o bastante para guiar cortes; não dispare nada no > palco."* *Observar eventos da bridge pode continuar read-only: use para provar que tempo, batida ou gesto estão chegando antes de mapear isso para mudanças visíveis.* > *"Me ensine TouchDesigner o suficiente para mexer neste patch com segurança: > mostre o caminho do operador que devo abrir, um parâmetro para testar primeiro e > um fallback se quebrar."* *Recursos de aprendizado e cheatsheets ficam artist-facing quando reduzem medo no patch: um operador, um parâmetro seguro, um caminho de volta.* > *"Olhe para a saída atual e critique como motion designer: paleta, contraste, > ritmo, legibilidade e um próximo ajuste concreto."* *O copiloto local deve fechar o ciclo entre rede gerada e resultado visível: descrever o que está na tela, nomear a escolha artística mais fraca e propor uma mudança pequena para o artista aprovar.* ## Conhecimento TD offline & rascunhos de receita Use estes prompts quando quiser que o agente leia conhecimento TouchDesigner embutido antes de criar nós. As tools desta seção são read-only e funcionam sem bridge TD ao vivo; qualquer cook ou checagem de projetor continua **UNVERIFIED-pending-td** até você rodar o rascunho contra uma instância TouchDesigner conectada. > *"Antes de escolher o estágio de blur, busque operadores TOP embutidos no > TouchDesigner 2023 com busca por parâmetros ligada. Mostre quais operadores > expõem controles ligados a borda, raio ou feedback, e ainda não crie nós."* ```bash tdmcp-agent operators \ --params '{"query":"edge radius feedback blur","category":"TOP","version":"2023","parameter_search":true,"limit":8}' ``` *O `search_operators` expandido filtra por categoria, versão do TouchDesigner e metadados de parâmetros antes de o agente mexer no projeto. Use quando a pergunta é "qual operador expõe o controle de que preciso?", não só "como chama este op?".* > *"Estou migrando um patch de feedback de 2022 para 2024 e quero uma cadeia de > trails segura para câmera. Planeje primeiro a migração de versão do TD, depois > sugira uma cadeia TOP e valide antes de rascunhar a receita."* ```bash tdmcp-agent versions migration-plan \ --params '{"from_version":"2022","to_version":"2024","query":"TOP feedback camera trails"}' tdmcp-agent operators suggest-chain \ --params '{"goal":"camera-safe feedback trails","family":"TOP","max_steps":5}' tdmcp-agent operators validate-chain \ --params '{"chain":["Video Device In TOP","Feedback TOP","Transform TOP","Level TOP","Null TOP"],"family":"TOP"}' tdmcp-agent recipes draft-chain \ --params '{"chain":["Video Device In TOP","Feedback TOP","Transform TOP","Level TOP","Null TOP"],"id":"camera_feedback_trails_draft","tags":["draft","feedback","migration"]}' ``` *Este é um preflight atento à versão: notas de release e registros de compatibilidade orientam a sugestão de cadeia, `validate_operator_chain` checa as adjacências de operadores e o rascunho de receita continua offline até um `apply_recipe` posterior com cook ao vivo no TD.* > *"Abra o pacote embutido de técnicas GLSL, inspecione uma técnica de > reaction-diffusion com notas de setup e código, então gere um rascunho de > receita válido no schema em modo non-strict. Deixe aplicar isso para uma passada > ao vivo no TD depois."* ```bash tdmcp-agent techniques get \ --params '{"category":"glsl","technique_id":"reaction_diffusion_gs","include_code":true,"include_setup":true}' tdmcp-agent techniques draft-recipe \ --params '{"category":"glsl","technique_id":"reaction_diffusion_gs","id":"reaction_diffusion_gs_technique_draft","strict":false}' ``` *`get_technique_detail` e `draft_recipe_from_technique` transformam pacotes embutidos de técnicas TouchDesigner em candidatos `RecipeSchema` sem afirmar que a rede já cozinhou. Preserve warnings e próximos passos sugeridos, então valide o rascunho no TouchDesigner antes de virar receita de show.* > *"Encontre o tutorial embutido para escrever um GLSL TOP, tente um rascunho de > tutorial em modo de triagem non-strict e me mostre por que ele é ou não é seguro > antes de aplicar qualquer coisa."* ```bash tdmcp-agent tutorials get \ --params '{"name":"write_a_glsl_top","include_content":true}' tdmcp-agent tutorials draft-recipe \ --params '{"name":"write_a_glsl_top","strict":false,"max_steps":5}' ``` *`get_tutorial` recupera o texto estruturado do tutorial e os blocos de código; a tool `draft_recipe_from_tutorial` valida a cadeia extraída com checagens de conexões documentadas. Para o tutorial embutido `write_a_glsl_top`, o resultado esperado é continuar sem rascunho: a cadeia extraída de texto/TOC inclui links adjacentes sem documentação, como `GLSL TOP -> GLSL Multi TOP`; o relatório deve incluir `undocumented_connection`, omitir `apply_recipe` e deixar o grafo TD intocado.* > *"Antes de criar uma cadeia de post com feedback, compare os docs de operator de > Blur TOP e Level TOP, valide `Noise TOP -> Blur TOP -> Level TOP -> Null TOP`, > então gere uma receita dessa cadeia sem tocar no projeto."* ```bash tdmcp-agent operators compare-docs \ --params '{"operator_a":"Blur TOP","operator_b":"Level TOP"}' tdmcp-agent operators validate-chain \ --params '{"chain":["Noise TOP","Blur TOP","Level TOP","Null TOP"],"family":"TOP"}' tdmcp-agent recipes draft-chain \ --params '{"chain":["Noise TOP","Blur TOP","Level TOP","Null TOP"],"id":"feedback_post_draft","tags":["draft","feedback"]}' ``` *Este é o loop seguro de "ler, comparar, validar e rascunhar": o agente explica os tradeoffs dos operadores e entrega um rascunho de receita válido no schema enquanto o grafo TouchDesigner real permanece inalterado.* > *"Busque tutoriais embutidos sobre fluxos CHOP, copie um id de tutorial dos > resultados, tente `draft_recipe_from_tutorial` em modo non-strict e, se não der > para gerar uma receita, explique o motivo. Use os operadores extraídos como > entrada para `validate_operator_chain` e só gere uma receita quando a cadeia > corrigida não tiver erros. Trate `apply_recipe` como handoff posterior, não como > parte desta execução."* ```bash tdmcp-agent tutorials get \ --params '{"query":"CHOP","include_content":true,"limit":3}' tdmcp-agent tutorials draft-recipe \ --params '{"name":"anatomy_of_a_chop","strict":false,"max_steps":5}' ``` *Esse é o modo de falha útil: um tutorial ainda pode ensinar o que o agente deve inspecionar ou validar, mesmo quando não vira uma receita segura automaticamente. `draft_recipe_from_tutorial` recebe um id de tutorial ou nome exato, não uma busca livre; substitua pelo id escolhido no resultado anterior.* ## Biblioteca criativa (Creative RAG) O repertório criativo é um índice local opt-in de referências artísticas com licença aberta. O CLI é `tdmcp creative-rag `; tanto `tdmcp://creative/cards/{id}` quanto `tdmcp://creative/search{?q,k,license,type,tags}` são recursos MCP somente leitura. A RAG fornece obras de fonte, paletas, linguagem de movimento e affordances de tools; o build TouchDesigner continua acontecendo pelas tools normais do tdmcp. > *"Use a Creative RAG para encontrar o card CC0 da Cleveland `The Biglin Brothers > Turning the Stake`. Use a própria pintura como material de origem: estique a > linha d'água em trilhas horizontais, detecte bordas nos remos e corpos, e > transforme isso num visual de movimento de remo com grade fria de palco."*

*Uma obra da RAG vira material de entrada, não uma linha de resultado: a imagem CC0 do card é remixada em um novo estudo de trilhas cinéticas usando água, ritmo dos remos e silhuetas da pintura como partitura visual.* > *"Busque na Creative RAG o card CC0 de retrato `Nathaniel Hurd`. Crie um novo > look de máscara ao vivo a partir dele: extraia uma paleta quente do retrato, > pixelize o rosto em blocos, adicione contornos e faça um drift sutil de dupla > exposição para backdrop performável."*

*O retrato recuperado dirige o look: cor, luz e estrutura do rosto viram um novo sistema de máscara/mosaico que pode ser recriado com `create_palette`, `create_pixel_sort` e passes de post-processing.* > *"Abra o card `Composition` de Wassily Kandinsky na Creative RAG. Use sua > geometria hard-edged, a paleta de tríade primária e os affordances > `create_generative_art` / `create_color_grade` para construir um sistema TD > geométrico novo, não uma cópia da pintura."*

*O card passa paleta e linguagem visual; o resultado é uma composição procedural nova com grid animado, círculos e planos de cor, mantendo a obra original como contexto de repertório em vez de algo que a RAG executa diretamente.* ### Busca e filtros de licença O repertório criativo é um índice local opt-in de referências artísticas com licença aberta. O CLI é `tdmcp creative-rag `; tanto `tdmcp://creative/cards/{id}` quanto `tdmcp://creative/search{?q,k,license,type,tags}` são recursos MCP somente leitura. A allowlist padrão (`TDMCP_RAG_LICENSE_ALLOWLIST`, default `CC0,PublicDomain`) só barra **download de binários** no `sync` — o `search` continua devolvendo qualquer card do índice. Passe `--license` explicitamente quando precisar de garantia firme sobre o que vai reusar. > *"Busque na biblioteca criativa referências kinéticas em monocromático — > muito movimento, preto e branco, geométrico. Limite a CC0 + domínio público > para eu poder reusar tudo que vier."* ```bash tdmcp creative-rag search "kinetic monochrome geometric" \ --license CC0,PublicDomain --k 5 --json ``` ```json [ { "id": "a1b2c3d4...", "score": 0.78, "title": "Composition with Black Lines", "sourceUrl": "https://www.artic.edu/...", "license": "PublicDomain", "type": "artwork", "tags": ["geometric", "monochrome", "motion-study"] }, { "id": "e5f6a7b8...", "score": 0.74, "title": "Rhythm of a Russian Dance", "sourceUrl": "https://www.rijksmuseum.nl/...", "license": "CC0", "type": "artwork", "tags": ["kinetic", "dance", "geometry"] } ] ``` *Use `--json` quando precisar dos ids para o próximo passo. A tabela humana é mais curta de propósito e imprime score, título, tipo/licença e source URL; o payload estruturado adiciona `id`, `tags` e outros campos do card para agentes ou scripts.* > *"Me mostre só obras de arquitetura com licença CC0 da biblioteca criativa."* ```bash tdmcp creative-rag search "architecture facade" \ --license CC0 --type artwork --tags architecture --k 5 --json ``` ```json [ { "id": "3f4d5e6a...", "score": 0.81, "title": "Facade Study, Rietveld Schroder House", "sourceUrl": "https://www.rijksmuseum.nl/...", "license": "CC0", "type": "artwork", "tags": ["architecture", "de-stijl", "geometric"] }, { "id": "c7d8e9f0...", "score": 0.77, "title": "Steel Frame, Construction Series", "sourceUrl": "https://www.clevelandart.org/...", "license": "CC0", "type": "artwork", "tags": ["architecture", "structure", "grid"] } ] ``` *`--license CC0` estreita mais que o padrão (descarta PublicDomain), então o resultado é estritamente CC0. `--type` aceita o enum da CLI (`project|artist|artwork|technique|cue_reference`); use `--tags` (CSV) para filtros mais finos como `architecture`, `geometric`, `sculpture`. Todos os filtros empilham.* > *"Abra o card `3f4d5e6a…` da biblioteca criativa e resuma a intenção do artista > para eu construir uma cena no TD a partir dela."* O cliente MCP busca `tdmcp://creative/cards/3f4d5e6a…` (onde `id = sha256(sourceUrl)`) e recebe o card completo em JSON: ```json { "id": "3f4d5e6a...", "schemaVersion": 1, "type": "artwork", "title": "Facade Study, Rietveld Schroder House", "sourceUrl": "https://www.rijksmuseum.nl/...", "sourceName": "rijksmuseum", "license": "CC0", "body": "Frontal study of a De Stijl facade with rigid planes and window-grid rhythm.", "tags": ["architecture", "de-stijl", "geometric", "primary-colors"], "palette": ["#E63946", "#F1FAEE", "#1D3557", "#FFD166"], "visualLanguage": "rigid orthogonal grid, flat planes", "tdmcpAffordances": ["create_glsl_shader", "create_grid_layout"], "contentHash": "sha256:..." } ``` *A shape real do card é plana: `body`, `palette` e `visualLanguage` são campos opcionais de primeiro nível, `type` precisa ser um dos valores do enum da Creative RAG, e `tdmcpAffordances` é `string[]` com nomes de tools sugeridas (veja `src/creativeRag/schema.ts`). Leia o card, destile a intenção em prosa e então repasse os affordances + paleta para a tool de Layer 1 que se encaixar — por exemplo, "usa essa paleta e o `visualLanguage` em grade pra montar uma cena GLSL monocromática kinética". O cookbook para aqui; o build real fica para a tool de Layer 1 que os affordances indicam.* ## Biblioteca de projetos (Project RAG) O **repertório de projetos** é o primo dev da Creative RAG: um índice local opt-in de *projetos, componentes e snippets* de TouchDesigner sob licença aberta — arquivos `.toe`/`.tox` e trechos de shader puxados de fontes curadas no GitHub — para que o agente possa basear um efeito em **código TD real** antes de escrever qualquer node novo. O CLI é `tdmcp project-rag `; `tdmcp://project/cards/{id}`, `tdmcp://project/search{?q,k,license,type,operator,tags}` e o novo `tdmcp://project/sources` são resources MCP read-only. O prompt MCP `project_rag_context` e a tool de copiloto `project_rag_search` expõem o mesmo índice para clientes LLM — ambos gated por `TDMCP_RAG_ENABLED=1 && TDMCP_PROJECT_RAG_ENABLED=1`. ### Quando usar Project RAG vs Creative RAG Duas RAGs, duas perguntas. A Creative RAG responde *"como isso deveria parecer?"* — ela traz obras, paletas e linguagem visual. A Project RAG responde *"como isso é de fato construído no TD?"* — ela traz networks `.toe`/`.tox` funcionais e o wiring de operators que você pode ler ou adaptar. Misturar as duas é a ideia. > *"Quero montar uma peça de feedback com hand tracking. Primeiro rode o > prompt `project_rag_context` com `query: 'hand tracking mediapipe feedback'` > para eu ver como projetos TD reais fazem o wiring; depois escolha o de > licença mais permissiva e adapte a cadeia de operators para uma network > nova."* ```text tdmcp://project/search?q=hand+tracking+mediapipe+feedback&k=5 → 0.823 MediaPipe Hand Pose Demo [project] — MIT — tdmcp://project/cards/abc123… 0.781 Real-time Hand Tracker [project] — CC-BY-4.0 — tdmcp://project/cards/def456… 0.704 Feedback Optical Flow Hands [snippet] — Apache-2.0 — tdmcp://project/cards/789abc… ``` *O prompt retorna títulos, licenças e URIs `tdmcp://project/cards/{id}` — não embeddings opacos. Inspecione cada card via `read_resource` para ver a lista completa de operators e o caminho do binário que dá para abrir no TD. Use a Creative RAG para **paleta/clima**; use a Project RAG para **o wiring TD que faz a coisa se mover**.* ### Buscando exemplos reais antes de codar um efeito Quando o modelo vai *gerar* um efeito novo, o primeiro passo mais seguro é **buscar antes de sintetizar** — descobrir o que já existe, em código, sob uma licença que dá para reaproveitar. > *"Vou montar uma network de trails audio-reactive. Antes de criar qualquer > op, rode `tdmcp project-rag search 'audio reactive trails feedback' > --license CC0,MIT,Apache-2.0 --k 5` e cite os três cards do topo > (título + licença + URI). Abra o de licença mais permissiva via > `tdmcp://project/cards/{id}` e me diga quais operators ele usa. Aí a > gente decide se copia, adapta ou constrói do zero."* ```bash tdmcp project-rag search "audio reactive trails feedback" \ --license CC0,MIT,Apache-2.0 --k 5 ``` *O CLI espelha `tdmcp creative-rag search` — mesmo layout de flags, mesma história de reuso gated por licença. A diferença é que os cards aqui apontam para networks TD executáveis em vez de obras estáticas, e `--operator AudioSpectrumCHOP` filtra ainda mais para cards que de fato wirem um op específico. Quando a busca do lado creative volta com poucos resultados, o CLI também imprime no stderr uma dica sugerindo `tdmcp project-rag search ""` como cross-link, então o agente pivota entre as duas bibliotecas sem perder a query.* > *"Hoje à noite preciso de um look rápido de organismo de neblina. Liste > primeiro as fontes Project RAG configuradas via `tdmcp://project/sources` > — quero saber quais estão ready vs planned antes de buscar, para não > caçar cards que ainda não foram indexados."* ```json [ { "name": "github-repo", "displayName": "GitHub seed repos", "status": "ready" }, { "name": "github-topic", "displayName": "GitHub topic scanner", "status": "ready" }, { "name": "matthewragan", "displayName": "Matthew Ragan", "status": "planned" } ] ``` *`tdmcp://project/sources` é o mapa honesto do que está indexado localmente. Uma fonte com `status: "planned"` significa que o adapter existe mas não está wired no seu sync atual — contexto útil quando os resultados de busca vêm mais finos do que você esperava. Combine com o prompt `project_rag_context` para deixar o agente raciocinar sobre cobertura antes de comprometer com um caminho de build.* ### Habilitando o manual do Interactive & Immersive HQ (não comercial) Um manual inteiro de TouchDesigner está disponível como cards `tutorial` pesquisáveis — mas vem **desligado por padrão** porque sua licença é **CC-BY-NC-SA-4.0** (não comercial, share-alike, atribuição obrigatória). Ative-o apenas para uso pessoal/aprendizado: ```bash export TDMCP_PROJECT_RAG_IIHQ=1 tdmcp project-rag sync --source iihq tdmcp project-rag search "otimizar uma rede de CHOP lenta" --type tutorial --k 3 ``` > *"Habilite a fonte de tutoriais IIHQ e encontre capítulos que expliquem GLSL > TOPs. Cite a licença de cada card e me lembre dos termos de reuso antes de eu > copiar qualquer coisa para um show comercial."* *Todo card IIHQ é carimbado de forma rígida como `CC-BY-NC-SA · não comercial` e carrega notas de direitos dizendo para atribuir **The Interactive & Immersive HQ**, manter o uso não comercial e compartilhar sob a mesma licença. Apenas o **texto** do manual é indexado — nenhum binário `.tox`/`.toe`/exemplo é baixado (a política de licença nega binários CC-BY-NC-SA por completo). Se você está construindo para um trabalho pago, trate esses cards como leitura de referência, não como assets para distribuir.* ## Trabalhando a partir das suas notas (vault Obsidian) Se você mantém um [vault Obsidian](/reference/tools#obsidian-vault) conectado: > *"Monte o set de hoje a partir da minha nota de setlist 'Sexta'."* > *"Gere um visual a partir do meu moodboard 'fundo do oceano'."* > *"Salve este visual como uma receita no meu vault, rode auto-tagging e registre no > meu diário de shows."* > *"Lembre que meu estilo de show evita gradientes arco-íris chapados, prefere névoa > fria, luz de borda âmbar e câmera lenta, e use essa memória no próximo look."* > *"Ache trabalhos anteriores no meu vault parecidos com 'catedral submersa, névoa > azul, strobes lentos' e use o mais próximo como ponto de partida."* > *"Faça lint da minha biblioteca de receitas antes do show e me diga quais notas > têm assets ausentes, ids duplicados ou operadores desconhecidos."* **O que você recebe:** uma biblioteca local de show, amigável a git. `scaffold_vault` cria as pastas iniciais, incluindo `Memory/style.md`; as ferramentas de salvar podem usar auto-tags determinísticas; `recall_similar_work` busca seus próprios looks anteriores; e `lint_recipe_library` pega notas ruins antes delas chegarem ao projetor.