BounceSoul Studio · AyudaHelp
Manual del editor: conexión, creación de bailes, vista 3D y guardado. Abrir esta ayuda no envía órdenes al coche.
Editor manual: connection, dance creation, 3D view and storage. Opening help sends no commands to the car.
Primeros pasos
Getting started
- Para probar sin coche
- Elige 3 o 4 servos, crea puntos u ondas y pulsa Solo vista 3D. No necesitas USB.
- Para probar en el coche
- Conecta USB, comprueba el estado confirmado y pon Coche: Active. Vista previa reproduce el baile en la placa; Probar manual aplica los deslizadores. Empieza con recorridos pequeños.
- Pause no apaga el coche
- En Pause la placa pasa las señales del mando al coche. Active habilita el control de la placa; no inicia por sí solo un baile.
- Try without a car
- Choose 3 or 4 servos, create points or waves, then press 3D view only. USB is not required.
- Try on the car
- Connect USB, check the confirmed status and select Car: Active. Preview plays the dance on the board; Test manually applies the sliders. Start with small movements.
- Pause does not turn the car off
- In Pause the board passes transmitter signals through to the car. Active enables board control; it does not start a dance by itself.
Cabecera y archivos .bounce
Header and .bounce files
- 3 servos / 4 servos
- Selecciona el modelo. En 3 servos hay una delantera compartida, dos traseras y dirección. Cambiar de 4 a 3 elimina la pista delantera derecha tras confirmarlo.
- Nuevo baile
- Crea un baile nuevo para editar. Descarga primero una copia si quieres conservar el actual fuera del borrador.
- Descargar .bounce
- Descarga el baile actual, incluidas sus ondas editables. El archivo permite compartirlo o abrirlo después.
- Importar .bounce
- Abre un archivo compatible. Si tiene otro perfil de servos, revisa la conversión antes de aceptarla.
- Ayuda e idiomas
- Ayuda abre este manual en otra pestaña sin cerrar el editor. México selecciona español; EEUU selecciona inglés. El navegador recuerda el idioma.
- 3 servos / 4 servos
- Select the model. A 3-servo car has a shared front, two rear tracks and steering. Switching from 4 to 3 removes Front Right after confirmation.
- New dance
- Creates a new dance to edit. Download a copy first if you want to retain the current dance outside the draft.
- Download .bounce
- Downloads the current dance, including editable waves. Use the file to share or reopen the dance.
- Import .bounce
- Opens a compatible file. If its servo profile differs, review the conversion before accepting.
- Help and languages
- Help opens this manual in another tab without closing the editor. Mexico selects Spanish; USA selects English. The browser remembers your language.
Conexión y reproducción
Connection and playback
- Conectar / Desconectar USB
- Conectar consulta el estado: no mueve el coche. En Chrome o Edge puede aparecer un selector de puerto. En el servidor local también existe un puente USB. Desconecta antes de usar otra aplicación con el puerto.
- Coche: Pause / Active
- Rojo tenue: control de la placa desactivado y mando en paso directo. Verde: control habilitado. El botón espera confirmación de la placa; sin USB no se puede cambiar.
- Vista previa
- Sin USB reproduce localmente. Con USB carga el baile en RAM e inicia la reproducción en la placa, si el estado y las comprobaciones lo permiten. El texto del botón indica el destino.
- Solo vista 3D
- Reproduce únicamente la simulación, incluso si hay USB conectado. No envía ese baile al coche.
- Capturar / Parar captura
- Registra cambios de los deslizadores como puntos mientras avanza el tiempo. No es una grabación de las señales de la emisora. Capturar no activa el coche por sí solo.
- Detener y Escape
- Detienen la prueba correspondiente. La parada USB necesita confirmación; comprueba el mensaje. Un baile autónomo puede continuar al desconectar el cable: desconectar no equivale a detener.
- Connect / Disconnect USB
- Connecting reads the state without moving the car. Chrome or Edge may show a port picker. The local server also provides a USB bridge. Disconnect before another app uses the port.
- Car: Pause / Active
- Muted red: board control disabled and transmitter passthrough enabled. Green: board control enabled. The button waits for board confirmation; it cannot change the state without USB.
- Preview
- Without USB, plays locally. With USB, loads the dance into RAM and starts board playback if the state and checks allow it. The button text indicates the destination.
- 3D view only
- Plays only the simulation, even with USB connected. Does not send that dance to the car.
- Capture / Stop capture
- Records slider changes as points over time. This does not record transmitter signals. Capture does not activate the car by itself.
- Stop and Escape
- Stop the relevant test. A USB stop requires acknowledgement; check the message. An autonomous dance may continue after unplugging USB: disconnecting is not the same as stopping.
Barra de herramientas y pistas
Toolbar and tracks
- Seleccionar
- Pulsa el nombre de una pista para seleccionarla. Un primer clic selecciona el punto; después puedes arrastrarlo. Mayús o Cmd permiten selección múltiple.
- Crear onda
- Abre las opciones de onda. Una onda es un bloque editable de ciclos, con inicio, periodo, repeticiones y amplitud.
- Añadir punto
- Añade un punto a la pista seleccionada en el instante del cursor. Ajusta su altura y transición en las propiedades.
- Deshacer
- Recupera el estado anterior de edición. No revierte una acción física ya realizada por el coche ni una escritura permanente en la placa.
- Copiar / Pegar pista
- Copia la pista seleccionada. Selecciona la pista destino y pega: se reemplaza su contenido, incluidas las ondas.
- Pegar invertida
- Pega reflejando la altura: 20 % pasa a 80 %, 50 % permanece igual. Conserva los tiempos; no invierte el orden temporal.
- Punto con X / Línea con X
- El primero borra la selección. El segundo limpia la pista seleccionada. Cada servo necesita conservar al menos un punto.
- Imán
- Activa el ajuste temporal a 50 ms, al cursor y a puntos o extremos próximos. Apágalo para ajustar libremente.
- Reducir · 2 %
- Simplifica puntos con una desviación máxima del 2 %. Revisa el resultado; puedes usar Deshacer.
- Restaurar
- Recupera la toma original conservada de la captura. Solo está disponible cuando existe esa toma.
- Limpiar
- Vacía los movimientos y ondas de todas las pistas, dejándolas en una postura inicial.
- Control manual
- Muestra u oculta el panel lateral. No activa por sí solo los servos.
- Select
- Click a track name to select it. A first click selects a point; then you can drag it. Shift or Cmd allow multiple selection.
- Create wave
- Opens wave options. A wave is an editable block of cycles with a start, period, repetitions and amplitude.
- Add point
- Adds a point to the selected track at the cursor time. Adjust its height and transition in the properties.
- Undo
- Restores the previous editing state. Does not reverse a physical car action or a permanent write to the board.
- Copy / Paste track
- Copies the selected track. Select a destination and paste: its content, including waves, is replaced.
- Paste inverted
- Pastes with reflected heights: 20% becomes 80%, while 50% is unchanged. Preserves timing; does not reverse time order.
- Point with X / Line with X
- The first deletes the selection. The second clears the selected track. Each servo must retain at least one point.
- Snap
- Enables time snapping to 50 ms, the cursor, and nearby points or edges. Turn it off for free adjustment.
- Simplify · 2 %
- Simplifies points with a maximum 2% deviation. Review the result; Undo is available.
- Restore
- Restores the retained original recording. Available only when such a recording exists.
- Clear
- Clears movements and waves from all tracks, leaving an initial pose.
- Manual control
- Shows or hides the side panel. Does not enable servos by itself.
Línea de tiempo y propiedades
Timeline and properties
- Puntos, barras y cursor
- Cada punto indica la altura que se alcanza en ese instante. La barra a su derecha representa el tiempo hasta el siguiente punto. Mueve el cursor con el deslizador Tiempo.
- Instante / Altura / Hasta siguiente
- Instante sitúa el punto en milisegundos; Altura define su porcentaje. Hasta siguiente cambia el tiempo y desplaza el punto siguiente. No introduce una pausa independiente.
- Aceleración
- Constante hace una transición lineal. Lento → rápido acelera; Rápido → lento frena al llegar.
- Duración y −1 s / +1 s / +5 s
- Cambian la duración del baile. También puedes arrastrar su extremo derecho. Revisa los puntos y ondas cercanos al final al acortarlo.
- Ondas
- Inicio sitúa el bloque. Periodo indica la duración media de cada ciclo; Repeticiones indica cuántos. Amplitudes inicial y final hacen crecer o reducir el recorrido. Forma elige suave, lineal o golpe seco.
- Más opciones de onda
- Puntos inicial y final fijan las alturas de entrada y salida; Centro desplaza el centro del recorrido. Cambio de amplitud y aceleración regulan cómo evoluciona el bloque. El recorrido debe quedar entre 0 y 100 %.
- Añadir / Actualizar / Borrar onda
- Añadir crea el bloque; al seleccionar uno existente puedes actualizarlo o borrarlo. Arrastra el bloque para moverlo y sus extremos para cambiar sus tiempos.
- Points, bars and cursor
- Each point specifies the height reached at that time. The bar to its right represents the time until the next point. Move the cursor using the Time slider.
- Time / Height / Until next
- Time positions the point in milliseconds; Height sets its percentage. Until next changes the interval and moves the next point. It does not add a separate pause.
- Easing
- Constant gives a linear transition. Slow → fast accelerates; Fast → slow decelerates on arrival.
- Duration and −1 s / +1 s / +5 s
- Change dance duration. You can also drag its right edge. Review points and waves near the end when shortening it.
- Waves
- Start positions the block. Period sets average cycle duration; Repeats sets the count. Initial and final amplitudes grow or shrink travel. Shape selects smooth, linear or sharp hit.
- More wave options
- Start and end points set entry and exit heights; Centre shifts the travel centre. Amplitude change and easing control block progression. Travel must stay within 0–100%.
- Add / Update / Delete wave
- Add creates a block; select an existing one to update or delete it. Drag the block to move it and its edges to change timing.
Control manual y vista 3D
Manual control and 3D view
- Deslizadores
- Preparan las alturas y la dirección. Sin prueba manual activa solo cambian la postura local. En 3 servos la delantera es compartida.
- Probar manual / Detener manual
- Con USB y Active, permite aplicar la postura al coche. Al desactivarlo solicita la vuelta a Neutral. Revisa la confirmación del estado.
- Pasar postura a la línea de tiempo
- Escribe la postura preparada en todas las pistas en el instante del cursor. No equivale a activar el coche.
- Zoom, Frontal, Perspectiva y Lateral
- Cambian únicamente la cámara. Arrastra sobre el modelo para girarlo. La malla muestra órdenes del editor, no una medida real ni una garantía de contacto con el suelo.
- Ampliar
- Abre la vista flotante. Puedes moverla arrastrando su cabecera; Cerrar vista ampliada la devuelve a su lugar.
- Sliders
- Prepare heights and steering. Without active manual testing, they only change the local pose. The 3-servo front is shared.
- Test manually / Stop manual control
- With USB and Active, applies the pose to the car. Disabling it requests a return to Neutral. Check state confirmation.
- Add pose to timeline
- Writes the prepared pose to all tracks at the cursor time. Does not activate the car.
- Zoom, Front, Perspective and Side
- Change only the camera. Drag on the model to rotate it. The mesh displays editor commands, not a physical measurement or a guarantee of ground contact.
- Expand
- Opens the floating view. Drag its header to move it; Close expanded view returns it to its original position.
Archivos y guardado
Files and storage
- Ejemplos / Cargar selección
- Carga un ejemplo para editar; no mueve el coche. Los ejemplos son referencias que conviene probar y adaptar a cada montaje.
- Nombre / Guardar versión .bounce
- Nombre identifica el baile. Guardar versión descarga una copia numerada, como baile_v01.bounce. El borrador automático del navegador no sustituye a esta copia.
- Espacios 1–3 / Guardar / Abrir
- Son tres espacios permanentes de la placa. Guardar escribe el baile; Abrir lo trae al editor. Sobrescribir pide confirmación. El guardado tiene un límite de 672 puntos; reducir puede ayudar.
- RAM y memoria permanente
- La RAM sirve para reproducir y se pierde al apagar. Los espacios permanentes conservan los bailes. Descargar .bounce guarda un archivo en tu ordenador, no en la placa.
- Vista .bounce
- Muestra la representación del baile para consultarla. El idioma de la interfaz no cambia las claves del formato ni el nombre de tu archivo.
- Examples / Load selection
- Loads an example for editing without moving the car. Examples are references to test and adapt to each setup.
- Name / Save version .bounce
- Name identifies the dance. Save version downloads a numbered copy such as dance_v01.bounce. The browser automatic draft is not a substitute for this copy.
- Slots 1–3 / Save / Open
- Three permanent board slots. Save writes the dance; Open loads it into the editor. Overwriting requires confirmation. Storage is limited to 672 points; simplification can help.
- RAM and permanent storage
- RAM is used for playback and is lost at power-off. Permanent slots retain dances. Download .bounce saves a file on your computer, not on the board.
- .bounce view
- Shows the dance representation for inspection. UI language does not change format keys or your filename.
Problemas habituales
Troubleshooting
- No conecta USB
- Comprueba cable de datos y puerto. Cierra monitores serie o desconecta otras pestañas que lo usen. Tras reiniciar o actualizar la placa, reconecta. La conexión funciona también en Pause.
- Conecta, pero no mueve
- Comprueba Coche: Active y el destino de la prueba. Solo vista 3D no mueve el coche. Revisa los mensajes sobre Neutral, emisora e IMU; no fuerces una orden rechazada.
- Sin confirmación / desconexión
- El editor no puede asegurar el estado del coche. Reconecta y consulta el estado antes de continuar. Un baile autónomo puede seguir activo.
- No permite guardar o crear una onda
- Revisa límites de memoria, número de puntos, duración y solapamientos. Las ondas deben quedar dentro del baile y del recorrido 0–100 %.
- USB will not connect
- Check the data cable and port. Close serial monitors or disconnect other tabs using it. Reconnect after restarting or updating the board. Connecting also works in Pause.
- Connected but no movement
- Check Car: Active and the preview destination. 3D view only does not move the car. Review messages about Neutral, transmitter and IMU; do not force a rejected command.
- No acknowledgement / disconnection
- The editor cannot confirm the car state. Reconnect and check status before continuing. An autonomous dance may still be active.
- Cannot save or create a wave
- Check memory limits, point count, duration and overlaps. Waves must fit within the dance and the 0–100% range.