tag:github.com,2008:https://github.com/tolik518/bitmap_type_tracer/releasesRelease notes from bitmap_type_tracer2023-11-01T21:14:17Ztag:github.com,2008:Repository/710387145/v1.1.02023-11-01T21:49:10Zv1.1.0: Added translation system<p>The language of the program now sets itself to one of the available languages. If your language is not supported it will be set to English.<br>
If you want to override the language, you can use the <code>--lang [en|fr|tr|it|...]</code> parameter as the param at the end.</p>
<h2>New Params</h2>
<ul>
<li><code>--help</code> show help</li>
<li><code>--version</code> show the current program version</li>
<li><code>--lang [en|fr|tr|it|...]</code> overrides the language of the program</li>
</ul>
<h2>New Contributors</h2>
<ul>
<li><a class="user-mention notranslate" data-hovercard-type="user" data-hovercard-url="/users/Tizzz-555/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/Tizzz-555">@Tizzz-555</a> made their first contribution in <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="1967103661" data-permission-text="Title is private" data-url="https://github.com/tolik518/bitmap_type_tracer/issues/8" data-hovercard-type="pull_request" data-hovercard-url="/tolik518/bitmap_type_tracer/pull/8/hovercard" href="https://github.com/tolik518/bitmap_type_tracer/pull/8">#8</a></li>
<li>@Sam654123 made their first contribution in <a class="issue-link js-issue-link" data-error-text="Failed to load title" data-id="1968716645" data-permission-text="Title is private" data-url="https://github.com/tolik518/bitmap_type_tracer/issues/10" data-hovercard-type="pull_request" data-hovercard-url="/tolik518/bitmap_type_tracer/pull/10/hovercard" href="https://github.com/tolik518/bitmap_type_tracer/pull/10">#10</a></li>
</ul>
<p><strong>Full Changelog</strong>: <a class="commit-link" href="https://github.com/tolik518/bitmap_type_tracer/compare/v1.0.0...v1.1.0"><tt>v1.0.0...v1.1.0</tt></a></p>tolik518tag:github.com,2008:Repository/710387145/v1.0.02023-10-26T21:35:24Zv1.0.0: First release<h3>Font Source</h3>
<p>The fonts used in this project are sourced from <a href="https://github.com/ianhan/BitmapFonts/tree/main">ianhan/BitmapFonts</a> repository.</p>
<h3>Installation</h3>
<p>Just download the release below and untar it, but I would recommend installing using <code>cargo install</code>:</p>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="tar -xzvf bitmap_type_tracer_no_examples.x86_x64_linux.tar.gz
OR
tar -xzvf bitmap_type_tracer.x86_x64_linux.tar.gz"><pre>tar -xzvf bitmap_type_tracer_no_examples.x86_x64_linux.tar.gz
OR
tar -xzvf bitmap_type_tracer.x86_x64_linux.tar.gz</pre></div>
<p>The recommended way is to make sure you have <a href="https://www.rust-lang.org/tools/install" rel="nofollow">Rust</a> installed on your system.<br>
Then, run the following command to install the tool:</p>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="cargo install bitmap_type_tracer --locked"><pre>cargo install bitmap_type_tracer --locked</pre></div>
<h3>How to Run</h3>
<h4>Specifying Arguments Directly:</h4>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="bitmap_type_tracer <path_to_font_image> <sequence> <text> <chars_per_row> [--top VALUE] [--bottom VALUE] [--left VALUE] [--right VALUE] [--threshold VALUE] [--save-json]"><pre>bitmap_type_tracer <span class="pl-k"><</span>path_to_font_image<span class="pl-k">></span> <span class="pl-k"><</span>sequence<span class="pl-k">></span> <span class="pl-k"><</span>text<span class="pl-k">></span> <span class="pl-k"><</span>chars_per_row<span class="pl-k">></span> [--top VALUE] [--bottom VALUE] [--left VALUE] [--right VALUE] [--threshold VALUE] [--save-json]</pre></div>
<p>example:</p>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="bitmap_type_tracer "examples/4138906397_0dc616813b_o.png" " !\" '()*+,-.\\0123456789:; = ? ABCDEFGHIJKLMNOPQRSTUVWXYZ " "Bitmap Type Tracer" 10 --threshold 1 --save-json"><pre>bitmap_type_tracer <span class="pl-s"><span class="pl-pds">"</span>examples/4138906397_0dc616813b_o.png<span class="pl-pds">"</span></span> <span class="pl-s"><span class="pl-pds">"</span> !<span class="pl-cce">\"</span> '()*+,-.<span class="pl-cce">\\</span>0123456789:; = ? ABCDEFGHIJKLMNOPQRSTUVWXYZ <span class="pl-pds">"</span></span> <span class="pl-s"><span class="pl-pds">"</span>Bitmap Type Tracer<span class="pl-pds">"</span></span> 10 --threshold 1 --save-json</pre></div>
<h4>Using Font Configuration:</h4>
<p>For this method, you will need to have a font configuration file saved. You can do this by running the command with the <code>--save-json</code> flag when you specified all the arguments.</p>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="bitmap_type_tracer <path_to_font_image> <text>"><pre>bitmap_type_tracer <span class="pl-k"><</span>path_to_font_image<span class="pl-k">></span> <span class="pl-k"><</span>text<span class="pl-k">></span></pre></div>
<p>example:</p>
<div class="highlight highlight-source-shell notranslate position-relative overflow-auto" data-snippet-clipboard-copy-content="bitmap_type_tracer "examples/4138906397_0dc616813b_o.png" "Bitmap Type Trace""><pre>bitmap_type_tracer <span class="pl-s"><span class="pl-pds">"</span>examples/4138906397_0dc616813b_o.png<span class="pl-pds">"</span></span> <span class="pl-s"><span class="pl-pds">"</span>Bitmap Type Trace<span class="pl-pds">"</span></span></pre></div>
<p>This command will generate an image using a previously saved font configuration for the provided font image and the specified text.</p>
<p><strong>Arguments:</strong></p>
<ul>
<li>
<p><code><path_to_font_image></code>: Path to the font image (bitmap) you want to use.</p>
</li>
<li>
<p><code><sequence></code>: A sequence of characters as they appear in the font bitmap.</p>
</li>
<li>
<p><code><text></code>: The text you want to generate as an image.</p>
</li>
<li>
<p><code><chars_per_row></code>: Number of characters in a row in the font bitmap.</p>
</li>
</ul>
<p><strong>Optional Flags:</strong></p>
<ul>
<li>
<p><code>--top VALUE</code>: Specify top margin. Default is 0.</p>
</li>
<li>
<p><code>--bottom VALUE</code>: Specify bottom margin. Default is 0.</p>
</li>
<li>
<p><code>--left VALUE</code>: Specify left margin. Default is 0.</p>
</li>
<li>
<p><code>--right VALUE</code>: Specify right margin. Default is 0.</p>
</li>
<li>
<p><code>--threshold VALUE</code>: Specify the threshold for color comparisons. Default is 0.</p>
</li>
<li>
<p><code>--save-json</code>: Save the provided configuration as a JSON file, making it easier to reuse in the future.</p>
</li>
</ul>tolik518