newJS
А вообще нужны ли эти инструкции по процессору в справке? Они настолько узкоспециализированные, что у меня мелькала мысль не вырезать ли эти 8 Мб файлов. По началу мне казалось что это какая то реклама процессоров. Потом я понял что это для разработчиков ASM, которые знают язык в совершенстве и просматривают в этой документации команды поддерживаемые процессорами, но нам это недопурибейсиковцам (по крайней мере мне) как до Пекина на корячках, тут у меня три темы мелькают перед глазами изучить спрайты, 3D, параллельно с написанием 2-х программ (жизненно необходимых), подписаться в самозанятые и выложить на русторе пару игр и прог, посмотреть что из этого выйдет. А ты пытаешься ради красоты, чтобы было исправить никому не нужный текст. Когда придёт время нужные люди всё исправят для себя, не нужно забирать у них работу. Я вот не против примеры бы хорошие воткнуть, больше пользы будет, но чтобы их воткнуть надо в совершенстве знать раздел, те же спрайт или 3D. Нужны такие примеры, чтобы вставил их в IDE и хотелось бы дорабатывать. А то зайдёшь в раздел, а там ни одного примера. Вон jacdelad три дня пытается дым сделать из раздела частиц, а пример на 30 строк (без коментов) вполне в справку можно воткнуть, или урезать чуть-чуть.

Smitis
Точно нет. Посмотрел справку 6.10, потом вернулся к началам 5.62, 5.70, ни в одной из них нет этого... удалю у себя тоже. Так если честно, смотрел оригинальные страницы и модернизированные, уж слишком они многословны и оригинальный контент перенесён вниз или между строк. Я принципиально за то чтобы сначала идёт оригинальный контент, а потом уже от себя с пометкой "от автора перевода". При чём уровни у всех разные, мне всё время приходится искать среди десятка примеров по массивам нужное и не нахожу. Например нужен многомерный массив, забыл как записывать так (2,3) или так (2)(3), причём как объявляется и как доступ к элементу (в AutoIt3 было [2][3], а перечисление [2, 3]) и вот начинаю крутить этот список примеров и вычитывать страницу текста. Хотя можно было по порядку от простейшего к сложным Объявление и доступ, потом двумерный, потом редко используемый многомерный, потом усложнённые со структурами - массив структур, потом массив внутри структуры, потом вообще профессиональные моменты, пересоздание, очистка, почему пустой массив с одним элементом, объявление массива без инициализации.
У меня тоже есть интересные вещи (условие, массив, битовый флаг), но всё это можно сделать отдельным разделом и ссылкой на него.
Скомпилировал, файл справки уменьшился на 0,53 Мб (5.94->5.41).

Отредактировано AZJIO (27.04.2024 00:29:02)

Найди, но учти, что я делал поиск по "??" двойным вопросам, когда проблема кодировки вместо юникодных символов знак вопроса, я нашёл их всех и исправил. Если ты их видел до этого, то можешь зря потратить время.
Кодировка 1251 помогает сделать поиск, вкладка "Поиск" работает. Потому что поиск работает только в ANSI, в однобайтовой кодировке. Именно поэтому я конвертировал все файлы в эту кодировку а юникоде-символы воспроизвёл с помощью псевдо-кода.

Отредактировано AZJIO (27.04.2024 22:20:00)

Можно добавить к имени раздела последнюю версию, с которой этот раздел работает. Вдруг пригодится.

Chr()
Исправить, теперь содержит диапазон работающих символов и суррогатных.

Отредактировано AZJIO (27.09.2024 17:21:28)

Скачать
Новая иконка - ссылка на официальную документацию.

Добавлены функции:
+ConvertDate
+UseDialogOpenGLGadget
+UseDialogScintillaGadget
+UseDialogWebGadget
+UseDialogWebViewGadget

Добавлены константы в функции где они применяются
#PB_Cipher_HMAC
#PB_2DDrawing_NativeText
#PB_EventType_ColumnClick
#PB_PixelFormat_NoAlpha
#PB_EventType_Refresh

11.10.2024
Добавлены функции:
AddPackDirectory
CatchPack

исправления для уже добавленных функций в плане перехода между функций (в нижней строке). Если вклинена функция то у предыдущей и последующей должны изменится переходы на добавленную. Также поправка в index.html, где эти функции должны быть перечислены списком, также в разделе HTTP в список вклинены ссылки с открытием во внешнем браузере. Всё уже сделано, но скомпилирую чуть позже, может ещё пару функций добавлю.
(ссылка обновлена)

План:
CreateAnimatedMaterial
CreateCubicTexture
CreateShader
CreateShaderMaterial
DeriveCipherKey
DraggedItemIndex
ExamineDraggedItems
NextDraggedItem
GetEntityMesh
MaterialAnimation
MaterialShaderAutoParameter
MaterialShaderParameter
MaterialShaderTexture
PackEntryDate
ScaleEntityBone
Text3DX
Text3DY
Text3DZ
VerifyPasswordHash

Skeleton (раздел)
AddSkeletonAnimationKeyFrame
CreateBone
CreateSkeleton
CreateSkeletonAnimation
FinishBoneAssignment
VertexBoneAssignment

Отредактировано AZJIO (26.10.2024 22:20:43)

Описание функций PushListPosition() и PopListPosition() не раскрывают понимание их работы, хотя частично.
Функцию PushListPosition() можно вызвать многократно, при это создаётся список указателей. При этом вызов PopListPosition() устанавливает последний указатель текущим и удаляет его из списка ListPosition(), то есть если мы 3 раза выбрали 2, 5, 8 элемент, то PopListPosition() при вызове сделает текущим 8-й, потом 5-й, потом 2-й. Лишний вызов PopListPosition() приведёт к ошибке, потому что в ListPosition() не будет указателей.

Изначально я думал что PushListPosition() создаёт один указатель и я могу несколько раз вызвать PopListPosition(), который всегда будет задавать то что задал PushListPosition(), но после попытки я сразу понял, что PopListPosition() можно вызвать 1 раз. Допустим у меня 3 цикла и после каждого я хотел бы иметь доступ к текущему, соответственно перед каждым циклом я должен вызвать PushListPosition(), а по завершению цикла вызвать PopListPosition(). То есть мое представление что я должен вызвать PushListPosition() один раз, а потом просто восстановить текущий вызывая три раза PopListPosition() накрылось медным тазом. Перечитываю справку, там есть упоминание (в PushListPosition()), что каждый вызов должен быть уравновешен, но ошибку то вызвала функция PopListPosition(), в которой об это ничего не сказано, и потом понимая что в названии функции присутствует "List", то я понимаю что это список позиций, а не просто запоминание позиции. Явно формулировка не проливает свет, на работу функции, если мне приходится тестировать её поведение.

Вот чтобы чел представлял для чего предназначена функция и в том числе что такое стек я и предложил описать работу функции.

Может тогда удалить описание функции FindString(), оставить только синтаксис, потому что для меня это как 2*2? Ну и до кучи ещё подрезать пару десятков функций? Цель же справки не удалять то, что вам известно и подстраиваться только под вас.

Вот моё предложение по улучшению PushListPosition().

В примечание добавить в начало, не удаляя то что там есть.

Отредактировано AZJIO (21.12.2024 15:52:19)

Я знаю общую характеристику понятия стек. Но иногда в общении мне странно упоминание стека, используется ли это для употребления терминов, чтобы показать себя выше других или чел действительно знает, о чём говорит, потому что при попытке употребления этих слов и начале вопросов начинаешь получать вместо ответов плавающее рассуждение и попытку борьбы с автором вопроса по причине не понимания челом использующим этот термин и невозможностью им его объяснить. Поэтому через время я многие вещи не спрашиваю, понимая, что чел сдуется и будет давать ссылки на общее описание понятия стек.
Чтобы не быть голословным выражение "функция помещается в стек" - помещается указатель на функцию? сейчас тут нет контекста и фраза вырвана из него, поэтому надо искать эти слова автора, чтобы понять его. И я боюсь что при попытке столкновения с этими терминами и обращением к вам я опять не увижу борьбу против неудобных вопросов, в которых автор поплывёт. Но ладно, вы заикнулись, я в будущем буду набрасывать вопросы. Но в данном описании проблема в том, что не я жду ответа на вопросы, а предлагаю правильно описать работу функции. То что вы положите указатель в стек или в ячейку памяти, не говорит о том что это список данных, это только место куда будет сохранён указатель. Я же предлагаю раскрыть тему что это не ячейка памяти или стек, а о том что это список, куда будут помещаться указатели при каждом вызове. Опять же "позиция запоминается в структуре стека" здесь нет ключевого смысла сохранение нескольких позиций, здесь сказано что "позиция" не "позиции", "position" не "positions". Разницу в отсутствии "s" вы видите? Опять же по вашей ссылке где в описании "структура стека", а по вашей  ссылке там просто стек. Структура имеет одинаковую длину на всём времени жизни. Как я должен угадать что есть какая то изменяющаяся в размере структура? Но есть список - пурибэйсиковский стандартный, который может быть объявлен в структуре и структура хранит указатель на список, структура не меняется в длину, а функционал списка позволяет управлять этим списком в структуре и что-то мне подсказывает, что этот функционал имеет те же свойства что и у списка пурибэйсиковского или тот же но с небольшой урезкой для работы в рамках этого функционала, то есть хранится указатель на список, хранится размер списка, при доступе к указателю перемещаемся сложением к указателю размера ширины Integer умноженного на число добавленных элементов, или пускай это будет стек, некий внутренний движок выделяющий некий буфер, где вставляются указатели и берутся сверху, пока не достигнет нуля.  Не важно как устроена эта фича пускай будет так или так, в контексте текущей функции важна упрощенная формулировка список позиций, а не просто одна позиция.
Вы заряженный на борьбу со мной, ваша позиция имеет мало смысла, потому что у меня цель сделать справку понятной, у вас цель борьба со мной, из-за чего ваши комментарии не несут полезных вещей для справки.

Вы пытаете давить на знание стек, не смотря на то, что я знаю общее понятие "стек". Справка вызвала непонимание работы функции. То есть по существующему факту, по прецеденту, а не по вашим фантазиям. Если что я считаю себя достаточно знакомым с программированием. Если описание вызывало у меня проблему, то есть по факту, а у вас что есть кроме борьбы со мной? Плюс я сделал объективный разбор, который не основывается на том знаете ли вы как работает функция, а основывается только на отсутствии логически завершённой формулировки, из которой не должно возникать вопросов как работает функция, не создаст ложного представления.
Описание это тоже как программирование, если вы не правильно понимаете бизнес договор, то это может вызвать проблемы, поэтому договор пишется так, чтобы все пункты были ясны для понимания. Вот поэтому я хочу, чтобы в формулировки отсутствовали лишние слова не несущие смысловой нагрузки, такие как в описании параметра List(), говорящие что нужно создать его с помощью NewList, как будто его можно создать и без этого ключевого слова, опять же его можно создать в структуре с ключевым словом List и есть подозрение что список в структуре также будет работать с функциями PushListPosition(), PopListPosition(), то есть как бы формулировка ещё не оказалось ложной.

Итак  текст

Structure Person
	List Num.i()
EndStructure

x.Person

For i = 0 To 11
	AddElement(x\Num())
	x\Num() = i
Next

SelectElement(x\Num(), 5)
Debug x\Num()
PushListPosition(x\Num())

ForEach x\Num()
	Debug x\Num()
Next

PopListPosition(x\Num())
Debug x\Num()

Получаем ещё и ложность описания, список создан с помощью List в структуре, как видим NewList тут вообще нет, а функции PushListPosition(), PopListPosition() работают.

Вы видите в моём примере ключевое слово NewList? И прочитайте описание ещё раз, найдите там упоминание NewList.

Вообще я считаю что у нас язык PureBasic и я в рамках этого языка не обязан знать другие языки для работы с PureBasic. По желанию вы можете об этом рассказывать, но справка должна описывать свой функционал без использования терминов другого языка.

Не кажется ли вам что текст "You must include the brackets after the list name." более излишен и очевиден по наличию синтаксиса, чем отсутствие тех вещей, что я указал?

Отредактировано AZJIO (21.12.2024 18:09:39)