Usagi 3DS Theme Editor: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = 3DS Theme Editor | image = https://dlhb.gamebrew.org/3dshomebrew/3DSThemeEditor.jpg|250px | type = PC Utilities | version = 1.0.12.1 | licence...")
 
m (Text replacement - "Category:3DS homebrew applications" to "")
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = 3DS Theme Editor
|title=Usagi 3DS Theme Editor
| image = https://dlhb.gamebrew.org/3dshomebrew/3DSThemeEditor.jpg|250px
|image=Usagi3dsthemeeditor2.png
| type = PC Utilities
|description=Custom Theme Creator + .Net Library.
| version = 1.0.12.1
|author=usagirei
| licence = Mixed
|lastupdated=2017/05/28
| author = usagirei
|type=Theme Tools
| website = https://gbatemp.net/threads/release-usagi-3ds-theme-editor-net-library-testers-wanted.412233/
|version=1.0.12.1
| download = https://dlhb.gamebrew.org/3dshomebrew/3DSThemeEditor.rar
|license=MIT
| source = https://dlhb.gamebrew.org/3dshomebrew/3DSThemeEditor.rar
|download=https://dlhb.gamebrew.org/3dshomebrews/usagi3dsthemeeditor.7z
|website=https://gbatemp.net/threads/release-usagi-3ds-theme-editor-net-library-testers-wanted.412233
|source=https://github.com/usagirei/3DS-Theme-Editor
}}
}}
<youtube>u-zuAveMZfM&t=4s</youtube>
Usagi 3DS Theme Editor is a WPF Based, Theme Editor for Nintendo 3DS (+.Net Library).


I felt that while great applications, the current alternatives were a bit lacking in the Preview and User Experience Department.
==Features==
* Usagi Theme Editor:
** Live (Animated) Preview - Supporting all Render Modes and Frame Types for both Screens.
** Colored and Textured Application/Folder Icons on the Preview.
** Animated Cursor on the Preview.
** Image Palette - Pick colors from up to 20 colors from the top and bottom images most used colors.
** BGM Preview (preview only, to generate the BGM.BCSTM, you may use the [[YATA Plus 3DS|YATA+ Converter]] or similar alongside this application).
** Image Dithering.
** Available in English, Brazilian Portuguese, Spanish (by dsoldier), Italian (by RayFirefist), French (by Kerouz).
* ThemeEditor Common:
** LZ11 De/Compression.
** Texture Encoding/Decoding.
** Image Data Operations: Dithering, Blitting, Rotating, Palette Generation, Grayscale.
** Theme Reading/Writing.


So, another alternative for Custom Theme Creators, hopefully easing the process of creating them:
==User guide==
===Usagi Theme Editor===
Requires:
* .Net Framework 4.5.
* Windows Operating System (WPF doesn't work under Mono. However there are some markup languages which do, you can try to fork and port it).


Usagi 3DS Theme Editor:
{| class="wikitable sortable" style="width: 900px;"
|-
! style="width: 25%;"|Image Palette
| Select colors from the (up to) 20 most used colors on the Top/Bottom Screen Background Images.
|-
! Animated Live Preview
| See Changes in Realtime, Animation is Toggleable.
|-
! BGM Preview
| Preview Only, No BCSTM Conversion Support.
|-
! Exports Preview Image
| Upon Exporting, preview.png will be generated.
|-
! Image Dithering
| Reduced Banding, Bayer8x8 Ordered, Example (2x Nearest Neighbor).
|-
! Top Screen Render Modes
| None, Solid Color, Solid Color & Texture, Texture.
|-
! Bottom Screen Render Modes
| None, Solid Color, Texture.
|-
! Top Screen Frame Types
| Fixed, Slow/Fast Scroll.
|-
! Bottom Screen Render Modes
| Fixed, Slow/Fast Scroll, Flip/Bounce Tiled.
|-
! Bottom Screen UI Elements
| Folder and Icon Borders, Solid Color and Textured.
|-
! Experimental CWAV Manager
| Add Sound Effects to your themes, optional support for ctr_WaveConverter (Required for Wav Conversion).
|-
! SMDH Generation
| Loads/Creates info.smdh file for [[Custom Home Menu Manager 2 3DS|CHMM2]].
|-
! Theme Sender
| Sends Themes over Network to CHMM2.
|-
! Localization
| English, Portuguese (Brazil), Spanish (by dsoldier), Italian (by RayFirefist), French (by Kerouz).
|-
|}


Requires: .Net Framework 4.5 Windows Operating System (WPF doesn't work under Mono! However there are some markup languages which do, you can try to fork and port it)
===ThemeEditor Common===
Requires:  
.NET Framework 4.5.


Features: Live (Animated) Preview: supporting all Render Modes and Frame Types for both Screens Colored and Textured Application/Folder Icons on the Preview Animated Cursor on the Preview Image Palette: pick colors from up to 20 colors from the top and bottom images most used colors BGM Preview: Preview only, to generate the BGM.BCSTM, you may use the YATA+ Converter or similar alongside this application Image Dithering: I hate banding, and i bet will now too: Example Available in the following languages English Brazilian Portuguese Spanish - by @dsoldier Italian - by @RayFirefist French - by @Kerouz
ThemeEditor Common is an object Oriented, Standalone Library for Handling the Theme Files.


The Library (ThemeEditor.Common):
Built from the Ground Up in a Object Oriented manner, you may use this for your own projects that require Loading/Editing the Theme files, without rewriting the wheel.


Requires: .Net Framework 4.5
==Screenshots==
https://dlhb.gamebrew.org/3dshomebrews/usagi3dsthemeeditor3.png


Built from the Ground Up in a Object Oriented manner, you may use this for your own projects that require Loading/Editing the Theme files, without rewriting the wheel
https://dlhb.gamebrew.org/3dshomebrews/usagi3dsthemeeditor4.png


Special Thanks to YATA, pk3DS and DSDecmp, from where the LZ11 Decompressing and Texture Decoding Algorithms were taken/ported from
https://dlhb.gamebrew.org/3dshomebrews/usagi3dsthemeeditor5.png


Downloads:
https://dlhb.gamebrew.org/3dshomebrews/usagi3dsthemeeditor6.png


Source Code: GitHub (MIT License) Releases: GitHub
==Changelog==
'''v1.0.12.1'''
* Bleeds Proper Image.


Theme with Dithering + Preview Sample: https://3dsthem.es/2031 Screenshots: http://imgur.com/a/t4yrm
'''v1.0.12.0'''
* Perform Edge-Bleeding upon non POT image Import.
* Fade-Out not present images drop-zone (highlight set images).
* Import/Export Colors and Flags to a Text File.
* Allow Changing Default (New) Theme (place a file named default_body_lz.bin on the application root).


If it crashes and you can reproduce it, the Feedback is Appreciated!
'''v1.0.11.0'''
* Fixed images not being auto-resized when dropped instead of loaded from menu
* Added Support for dropping .bin files in the Left Panel Area (Tabs)
* Added Quick Image Toolbar in the Right Panel Area (Preview): Allows dropping of image files on their respective buttons, as well as clicking to fire the File Browser Dialog. Screen Panels are no longer drop targets.


EDIT: If i got any of the credits wrong, make sure to notify me too!
'''v1.0.10.1'''
* Fixes Folder mode Preview Item Position.
 
'''v1.0.10.0'''
* Added Rotating 3D Folder on Top Screen (Visible under "Folder" Mode).
* Fixed #8 | Improved the pattern (Solid Color Texture) preview, should also yield correct previews and outputs now.
* Added Shadow Positions for Folder Back Arrow and Open Software Button.
* Added a few previously missing Colors.
* And some core changes.
 
[https://github.com/usagirei/3DS-Theme-Editor/releases Release notes.]
 
==Credits==
* Halley Comet Software - [https://www.hcs64.com/vgmstream.html vgmstream] - BGM Preview.
* Reisyukaku - [https://github.com/Reisyukaku/YATA YATA] - LZ11 De/Compression, Texture Decoding.
* kwsch - [https://github.com/kwsch/pk3DS/blob/master/pk3DS/3DS/LZSS.cs pk3DS] - LZ11 De/Compression.
* Barubary - [https://github.com/Barubary/dsdecmp/tree/master/CSharp/DSDecmp DSDecmp] - LZ11 De/Compression.
* 3DBrew WIKI - [https://www.3dbrew.org/wiki/ WIKI] - File Formats Specification.
 
==External links==
* GitHub - https://github.com/usagirei/3DS-Theme-Editor
* GBAtemp - https://gbatemp.net/threads/release-usagi-3ds-theme-editor-net-library-testers-wanted.412233

Latest revision as of 11:09, 6 May 2024

Usagi 3DS Theme Editor
Usagi3dsthemeeditor2.png
General
Authorusagirei
TypeTheme Tools
Version1.0.12.1
LicenseMIT License
Last Updated2017/05/28
Links
Download
Website
Source

Usagi 3DS Theme Editor is a WPF Based, Theme Editor for Nintendo 3DS (+.Net Library).

Features

  • Usagi Theme Editor:
    • Live (Animated) Preview - Supporting all Render Modes and Frame Types for both Screens.
    • Colored and Textured Application/Folder Icons on the Preview.
    • Animated Cursor on the Preview.
    • Image Palette - Pick colors from up to 20 colors from the top and bottom images most used colors.
    • BGM Preview (preview only, to generate the BGM.BCSTM, you may use the YATA+ Converter or similar alongside this application).
    • Image Dithering.
    • Available in English, Brazilian Portuguese, Spanish (by dsoldier), Italian (by RayFirefist), French (by Kerouz).
  • ThemeEditor Common:
    • LZ11 De/Compression.
    • Texture Encoding/Decoding.
    • Image Data Operations: Dithering, Blitting, Rotating, Palette Generation, Grayscale.
    • Theme Reading/Writing.

User guide

Usagi Theme Editor

Requires:

  • .Net Framework 4.5.
  • Windows Operating System (WPF doesn't work under Mono. However there are some markup languages which do, you can try to fork and port it).
Image Palette Select colors from the (up to) 20 most used colors on the Top/Bottom Screen Background Images.
Animated Live Preview See Changes in Realtime, Animation is Toggleable.
BGM Preview Preview Only, No BCSTM Conversion Support.
Exports Preview Image Upon Exporting, preview.png will be generated.
Image Dithering Reduced Banding, Bayer8x8 Ordered, Example (2x Nearest Neighbor).
Top Screen Render Modes None, Solid Color, Solid Color & Texture, Texture.
Bottom Screen Render Modes None, Solid Color, Texture.
Top Screen Frame Types Fixed, Slow/Fast Scroll.
Bottom Screen Render Modes Fixed, Slow/Fast Scroll, Flip/Bounce Tiled.
Bottom Screen UI Elements Folder and Icon Borders, Solid Color and Textured.
Experimental CWAV Manager Add Sound Effects to your themes, optional support for ctr_WaveConverter (Required for Wav Conversion).
SMDH Generation Loads/Creates info.smdh file for CHMM2.
Theme Sender Sends Themes over Network to CHMM2.
Localization English, Portuguese (Brazil), Spanish (by dsoldier), Italian (by RayFirefist), French (by Kerouz).

ThemeEditor Common

Requires: .NET Framework 4.5.

ThemeEditor Common is an object Oriented, Standalone Library for Handling the Theme Files.

Built from the Ground Up in a Object Oriented manner, you may use this for your own projects that require Loading/Editing the Theme files, without rewriting the wheel.

Screenshots

usagi3dsthemeeditor3.png

usagi3dsthemeeditor4.png

usagi3dsthemeeditor5.png

usagi3dsthemeeditor6.png

Changelog

v1.0.12.1

  • Bleeds Proper Image.

v1.0.12.0

  • Perform Edge-Bleeding upon non POT image Import.
  • Fade-Out not present images drop-zone (highlight set images).
  • Import/Export Colors and Flags to a Text File.
  • Allow Changing Default (New) Theme (place a file named default_body_lz.bin on the application root).

v1.0.11.0

  • Fixed images not being auto-resized when dropped instead of loaded from menu
  • Added Support for dropping .bin files in the Left Panel Area (Tabs)
  • Added Quick Image Toolbar in the Right Panel Area (Preview): Allows dropping of image files on their respective buttons, as well as clicking to fire the File Browser Dialog. Screen Panels are no longer drop targets.

v1.0.10.1

  • Fixes Folder mode Preview Item Position.

v1.0.10.0

  • Added Rotating 3D Folder on Top Screen (Visible under "Folder" Mode).
  • Fixed #8 | Improved the pattern (Solid Color Texture) preview, should also yield correct previews and outputs now.
  • Added Shadow Positions for Folder Back Arrow and Open Software Button.
  • Added a few previously missing Colors.
  • And some core changes.

Release notes.

Credits

  • Halley Comet Software - vgmstream - BGM Preview.
  • Reisyukaku - YATA - LZ11 De/Compression, Texture Decoding.
  • kwsch - pk3DS - LZ11 De/Compression.
  • Barubary - DSDecmp - LZ11 De/Compression.
  • 3DBrew WIKI - WIKI - File Formats Specification.

External links

Retrieved from ‘https://www.gamebrew.org/index.php?title=Usagi_3DS_Theme_Editor&oldid=154836’

Advertising: