{"id":4847,"date":"2018-01-24T18:21:11","date_gmt":"2018-01-24T18:21:11","guid":{"rendered":"https:\/\/www.use-snip.com\/kb\/?post_type=ht_kb&#038;p=4847"},"modified":"2020-08-05T23:24:31","modified_gmt":"2020-08-05T23:24:31","slug":"installing-snip-on-non-english-platforms","status":"publish","type":"ht_kb","link":"https:\/\/www.use-snip.com\/kb\/knowledge-base\/installing-snip-on-non-english-platforms\/","title":{"rendered":"Installing SNIP on non-English platforms"},"content":{"rendered":"<h3>Installing <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> on non-English platforms<\/h3>\n<p>At this time <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> is shipped with only English language textual strings (there are no translations).\u00a0 <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> will make use of various local conventions for numbers, times, and currency &#8211; but all message textual content is in US English.\u00a0 <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> can be run with whatever language is present on the host machine.<\/p>\n<p>The message strings internal to <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> are comprised of Unicode character strings, supporting all the worlds major languages.\u00a0 The Qt development framework takes care of local conventions and local language choices.\u00a0 So most user input supports the <em>character sets<\/em> and <em>diacritical marks<\/em> in the machines local language setting without issue.\u00a0 When <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> first starts, a minor console log report line states what setting are present on the platform.<\/p>\n<pre style=\"padding-left: 30px;\">Localization used, Country: Default \u00a0\u00a0 Language: Default<\/pre>\n<p>An exception to this general rule is when the NTRIP or HTML protocol specification demands the use of <em>ASCII only<\/em> which occurs in a few places.\u00a0 The contents of the <em>Caster Table<\/em> is an example of this.\u00a0 Under such times, <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> forces the expression to be in ASCII.<\/p>\n<h3>Multi-Language Use<\/h3>\n<p>Many people (if not most) install <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> on machines where there is more then one language package in use.\u00a0 As per the above, <strong><span style=\"color: #0000ff;\">SNIP<\/span><\/strong> is agnostic in this respect, but will use US English for its own various message strings.\u00a0 When using <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>&#8216;s ability to display Lat-Long points on a maps in a browser, additional internationalization is used.<\/p>\n<p>A few localization convention are used, mostly in the display of numbering, day and month names, and dates.\u00a0 Local character sets beyond Latin-1 are used whenever possible.\u00a0 Here is an example of a <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> Caster running in China.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-7078\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2020\/08\/BaseStationSum_CHN.png\" alt=\"\" width=\"533\" height=\"128\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2020\/08\/BaseStationSum_CHN.png 533w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2020\/08\/BaseStationSum_CHN-300x72.png 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2020\/08\/BaseStationSum_CHN-50x12.png 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2020\/08\/BaseStationSum_CHN-320x77.png 320w\" sizes=\"auto, (max-width: 533px) 100vw, 533px\" \/><\/p>\n<h3>Installing non-standard locations<\/h3>\n<p>The default installation path for <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> is at: <b>C:\\Program Files (x86)\\SNIP\\<br \/>\n<\/b><\/p>\n<p>This path is known to work for all releases of Windows from 7 onward. Some people prefer to select another location, and this also works.<\/p>\n<p>The <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> installer script also installs a number of needed DLLs by the Qt framework in this folder, and creating other folders under it as needed.\u00a0 These are required to run <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>.\u00a0 If they cannot be found, the application will fail to start. \u00a0 [<span style=\"color: #008000;\"><em><strong>Aside<\/strong><\/em><\/span>: any similar program build with Qt may have the same issues.\u00a0 This is a known shortcoming with the Qt framework at this time. ]<\/p>\n<h4>Problems with <span style=\"color: #ff0000;\"><strong>non-ASCII<\/strong><\/span> paths<\/h4>\n<p>A problem may occur at times when the user selects an installation path that contains non-ASCII characters in it.\u00a0\u00a0 The most common case of this seems to be when a user with a non-ASCII name installs <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> in their <em>documents<\/em> directory.\u00a0 Consider a user named &#8220;J\u00f5se&#8221; whose document directory path would be: C:\\Users\\J\u00f5se\\Documents<\/p>\n<p>In this case the ability to start <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> <strong><em>may<\/em> <\/strong>fail.\u00a0\u00a0 [Aside: The precise times when it fails are uncertain, many times it in fact does work. ]\u00a0\u00a0 If you encounter the below error message when starting <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span>, the use of non-ASCII characters in the path is the most likely cause.<\/p>\n<p style=\"text-align: center;\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-4853\" src=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/missingDLL-1.jpg\" alt=\"\" width=\"470\" height=\"249\" srcset=\"https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/missingDLL-1.jpg 470w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/missingDLL-1-300x159.jpg 300w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/missingDLL-1-50x26.jpg 50w, https:\/\/www.use-snip.com\/kb\/wp-content\/uploads\/2018\/01\/missingDLL-1-320x170.jpg 320w\" sizes=\"auto, (max-width: 470px) 100vw, 470px\" \/><\/p>\n<p style=\"padding-left: 30px;\"><strong>The Fix:\u00a0\u00a0\u00a0 <\/strong>To overcome this, simply reinstall <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> in a directory path containing only ASCII characters.<\/p>\n<p style=\"padding-left: 30px;\">From <span style=\"color: #0000ff;\"><strong>SNIP<\/strong><\/span> release 2.x onward, some additional path dependency mitigation logic has been added.\u00a0 But this is a known shortcoming of Qt in mixed language environments at this time.<\/p>\n<p>[<span style=\"color: #008000;\"><strong>Aside<\/strong><\/span>: The above message indicates that the file qwindows.dll cannot be found.\u00a0 In the default installation path this file exists at: C:\\Program Files (x86)\\SNIP\\bin\\platforms\\qwindows.dll\u00a0 In the above, the resulting path is null (in &#8220;&#8221;).\u00a0 This is a generic file used by the Qt environment to run its GUI on windows.]<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Installing SNIP on non-English platforms At this time SNIP is shipped with only English language textual strings (there are no translations).\u00a0 SNIP will make use of various local conventions for numbers, times, and currency &#8211; but all message textual content is in US English.\u00a0 SNIP can be run with whatever [&hellip;]<\/p>\n","protected":false},"author":13,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"footnotes":""},"ht-kb-category":[115],"ht-kb-tag":[398],"class_list":["post-4847","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-getting-started","ht_kb_tag-snip-installtion"],"_links":{"self":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/comments?post=4847"}],"version-history":[{"count":12,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4847\/revisions"}],"predecessor-version":[{"id":7079,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb\/4847\/revisions\/7079"}],"wp:attachment":[{"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/media?parent=4847"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-category?post=4847"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.use-snip.com\/kb\/wp-json\/wp\/v2\/ht-kb-tag?post=4847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}