Documentation

Installer ou mettre à jour

1. Téléchargez Orion4D-Halftone-Studio-V2-Windows-x64.zip sur la page des versions GitHub.
2. Extrayez l’archive dans un dossier où vous pouvez écrire, puis ouvrez Orion4D-Halftone-Studio-Portable-2.0.0.exe. L’application est portable.
3. Conservez le dossier models/ à côté de l’exécutable pour le détourage et la génération de profondeur hors ligne.
4. Dans Réglages, choisissez la langue, l’échelle d’interface entre 80 % et 130 % et le dossier de sortie. Cliquez sur Enregistrer settings.json.

Pour une mise à jour, extrayez la nouvelle version dans un dossier distinct, puis recopiez les préréglages, polices, SVG et préférences que vous souhaitez conserver. Ouvrez vos projets .orion4d depuis le menu Fichier.

Orion4D Halftone Studio est gratuit, avec dons facultatifs. La licence V2 et les notices des composants tiers sont incluses dans le paquet.

Créer une première trame

La barre du haut change de mode. Les réglages sont à gauche, l’aperçu au centre et les calques à droite.

1. Dans Image simple, cliquez sur Ouvrir / Remplacer l’image et sélectionnez votre source.
2. Choisissez Points vectoriels pour des formes exportables en SVG ou Points pixel pour un rendu matriciel.
3. Réglez l’espacement et la forme, puis utilisez Avant / Après pour comparer le résultat à la source.
4. Choisissez un format et une taille de sortie en haut de la fenêtre, puis cliquez sur Exporter. Enregistrez le document pour pouvoir reprendre vos réglages.

Taille d’entrée et taille de sortie

Taille d’entrée fixe les dimensions de travail avant traitement. Conservez la taille originale, choisissez un pourcentage de 25 à 200 % ou fixez le grand côté entre 1 024 et 8 192 px. Le redimensionnement préserve les proportions et la transparence. Le document conserve l’image source originale.

Retouche et profondeur

Utilisez Retouche N&B pour préparer les tons qui alimentent la trame monochrome. Vérifiez notamment que les ombres et les hautes lumières conservent les détails que vous souhaitez imprimer.

Le détourage utilise des modèles locaux. Vous pouvez ajuster le seuil du masque et la douceur du bord, puis exporter le détourage en PNG.

Dans Trame en relief, générez ou importez une carte de profondeur, puis activez le relief. L’intensité, la direction et le lissage règlent la déformation du motif. La vignette montre la carte elle-même, même lorsque le canevas affiche l’image traitée.

La section Normal Map peut générer des normales à partir de la profondeur ou importer un PNG de normales. Activez leur influence pour guider le placage de la trame.

Points vectoriels et pixel

Points vectoriels

Réglez la grille, l’espacement et la forme du point. L’Atelier vectoriel propose également les hachures continues, le pointillisme adaptatif et les contours Bézier. La précision d’analyse fixe la géométrie. Augmenter la résolution d’export affine sa restitution.

Pour utiliser un motif SVG personnalisé, placez le fichier dans svg_dots/ à côté de l’exécutable. Sélectionnez le style SVG personnalisé, puis rechargez la liste des formes.

Points pixel

Réglez l’échantillonnage, le traitement matriciel et la création du motif. Comparez les motifs à la taille d’export souhaitée. Le PNG conserve le rendu matriciel, et la sortie RVB 1 bit permet un résultat seuillé lorsque ce mode est sélectionné.

Impression et encres

Dans Avancé → Séparations, choisissez Impression, puis CMJN, bichromie, trichromie ou multi-encre. Le mode multi-encre accepte de quatre à huit encres et permet de calculer le mappage ou d’importer un profil ICC de sortie.

La palette multi-encre démarre en CMJN + orange et vert. Les nuanciers de tons directs proposent des tons variés, pastels, complémentaires et tertiaires.

1. Définissez la Taille d’impression pour que la linéature corresponde aux dimensions physiques.
2. Choisissez un motif global, un espacement et une couverture. Ouvrez une encre pour adapter son motif, sa courbe et son angle. Utilisez Réinitialiser toutes les courbes pour retrouver la réponse d’encrage linéaire.
3. Comparez les motifs tramés aux séparations à plat, puis envoyez les niveaux en calques ou exportez les séparations.

ASCII et nuage de mots

ASCII

Choisissez un style et un jeu de caractères, puis réglez les colonnes et la composition. Utilisez PNG pour le rendu, SVG pour les contours des glyphes ou TXT pour les styles en grille régulière.

Nuage de mots

Importez un texte ou une liste de mots au format TXT, CSV ou JSON. Ajustez leur poids et choisissez un masque de silhouette ou une analyse photo. Le réglage Photo / portrait est un point de départ pour une composition dense qui reprend les couleurs de l’image.

Importez une police TTF ou OTF dans le panneau typographie, ou placez-la dans fonts/. Le SVG exporte les glyphes en contours.

Calques et formats d’export

Le bouton Envoyer le résultat en calque ajoute le rendu au panneau Calques. Passez en vue Composition pour empiler, déplacer ou recolorer les encres. Un Alt-clic sur la visibilité isole un calque. Répétez le geste pour réafficher les calques.

Avant l’export d’une plaque, vérifiez la taille physique, les dimensions en pixels et le fond. Le document .orion4d conserve le travail éditable.

Le Contrôle impression aide à vérifier la finesse des détails, le blanc de soutien et le repérage. Selon le format, vous pouvez produire des films noirs, des négatifs ou des plaques en miroir.

Atelier de motifs

Ouvrez Atelier de motifs pour créer un motif réglable. Le Catalogue de motifs permet de parcourir et de comparer les motifs avant de les appliquer à une trame ou à une encre.

Enregistrez les combinaisons de réglages que vous souhaitez réutiliser avec les préréglages et les profils d’atelier. Les dossiers patterns/ et svg_dots/ font partie de la bibliothèque locale de la version portable.

Atelier 3D

Ouvrez l’atelier depuis la barre principale. Choisissez une création et travaillez la matière, l’éclairage et la vue avant de choisir une sortie.

Exportez une vue fixe en PNG ou le maillage en STL ou OBJ. Un OBJ texturé est livré avec son fichier MTL et les textures dans un ZIP à extraire ensemble. Les préréglages de l’atelier sont enregistrés dans presets/3d/.

Animation

Choisissez une rotation, un effet optique ou une formation et dispersion du rendu. La timeline permet d’ajouter, de déplacer ou de supprimer les images clés et de faire évoluer le cadrage et le zoom. Exportez en GIF ou en MP4 selon les réglages de la scène.

JS effets

1. Sélectionnez JS effets, puis chargez un exemple ou collez un script.
2. Cliquez sur Tester et appliquer. Aperçu à la volée relance le test après une courte pause quand le code ou un réglage change.
3. Renseignez la description et cliquez sur Enregistrer pour garder le code et les valeurs du script avec le préréglage.

Déclarez les curseurs, champs numériques, cases à cocher, listes, couleurs et champs texte dans un bloc JSON @orion4d-params. La fonction synchrone reçoit leurs valeurs dans params et modifie le tampon RGBA sur place. Le moteur local applique des limites de temps et de mémoire.

/* @orion4d-params
[
  {"key":"threshold","type":"slider","label":"Seuil","min":0,"max":255,"step":1,"default":128}
]
*/
function effect(pixels, width, height, params) {
  for (let i = 0; i < pixels.length; i += 4) {
    const tone = 0.2126 * pixels[i] + 0.7152 * pixels[i + 1] + 0.0722 * pixels[i + 2];
    const gray = tone >= params.threshold ? 255 : 0;
    pixels[i] = pixels[i + 1] = pixels[i + 2] = gray;
  }
}

Pour installer un préréglage JSON compatible, copiez-le dans presets/javascript/ à côté de l’exécutable et relancez l’application. Dans un calque à une encre, les pixels sombres ajoutent de l’encre et le blanc reste transparent.

MCP local

Dans Réglages → MCP local, activez le MCP et copiez la configuration dans votre client. Gardez Orion4D Halftone Studio et le document ouverts. Le client utilise --mcp-stdio et communique localement avec la fenêtre de l’application.

• orion_get_document lit le mode, la taille et les réglages modifiables.
• orion_list_presets liste les préréglages et orion_apply_preset applique une recette enregistrée.
• orion_set_mode change le mode 2D et orion_update_settings règle le traitement et les encres.
• orion_test_javascript teste un script sur la source. orion_save_javascript_preset enregistre le script appliqué.
• orion_preview renvoie un aperçu PNG. orion_export_png exporte dans le dossier configuré dans Orion4D Halftone Studio et orion_undo annule la dernière modification.

Pour une action 2D, revenez à la vue Traitement et fermez l’Atelier 3D. Après un déplacement de l’exécutable, recopiez la configuration pour actualiser son chemin.

Traitement par lot et préréglages

Préparez un rendu sur une image représentative et enregistrez ses réglages comme préréglage. Passez à Traitement par lot, choisissez le dossier source et la destination, puis sélectionnez les tailles d’entrée et de sortie avant de lancer le dossier. Dans les réglages généraux, vous pouvez conserver les sous-dossiers du lot et utiliser des noms d’export uniques.

Les préréglages sont classés par mode dans presets/. Gardez les bibliothèques et les modèles locaux avec le dossier portable lors d’un déplacement.

Dépannage

• Détourage ou profondeur indisponible. Vérifiez que models/ et ses sous-dossiers sont à côté de l’exécutable.
• Export d’animation lent. Essayez une durée plus courte, une cadence plus basse ou une résolution de sortie inférieure.
• Ancien exécutable verrouillé. Fermez Orion4D Halftone Studio et quittez les clients MCP qui utilisent cet exécutable. Recopiez la configuration MCP de la nouvelle version avant de les relancer.

Pour signaler un problème, indiquez la version de Windows, le moteur, les tailles d’entrée et de sortie, et les étapes de reproduction. Signaler un problème sur GitHub