نمط عرض الخريطة - .render.xml

في حال رغبتك في تعديل نمط العرض الافتراضي، تحتاج إلى مراجعة التعريف على GitHub. ستجد جميع أنواع الأنماط على هذا الرابط، لذا إذا كنت ستقوم بإنشاء نمط خاص بك، يمكنك العثور على أسهل مثال.

في حال قررت إنشاء نمط عرض مخصص خاص بك، قد تحتاج إلى إنشاء خرائطك الخاصة لإضافة عرض ميزات مخصصة.

أقسام نمط الخريطة

يتكون ملف نمط الخريطة من عدة أقسام.

القسم	الوصف
الرأس	يتكون من `name` (اسم النمط)، `defaultColor` (لون الخريطة الافتراضي يمكن تجاوزه بواسطة السمة defaultColor) و `depends` (يرث جميع الخصائص من النمط الأصلي).
المعلمات	تُعرف باسم `<renderingProperty>` ولها `attr` الذي سيتم استخدامه في النمط كاسم معلمة و `name`، `description` سيتم عرضها للمستخدم.
السمات و الثوابت	تُعرف باسم `<renderingAttribute>` و `<renderingConstant>` تسمح بإعادة استخدام نفس كتل أنماط العرض لكائنات الخريطة المختلفة
قسم الترتيب	يُعرف ككتلة `<order>`. يتم البحث عن كل كائن خريطة في قسم الترتيب لتحديد ما إذا كان سيتم عرضه كنقطة أو خط أو مضلع (`objectType`) وبأي `order` يجب عرضه. معلمات البحث (الإدخال): `tag`، `value`، `zoom`، `point` (صحيح أو خطأ)، `area` (نوع osm)، `cycle` (نقطة البداية والنهاية متطابقتين). نتيجة البحث (الإخراج): `objectType` (نقطة = 1، خط = 2، مضلع = 3)، `order` (0-255). يتم تعريف ترتيب العرض على النحو التالي: المضلعات، ظلال الخطوط، الخطوط، النقاط. إذا كان `order` متطابقًا للمضلعات، فسيتم عرض المضلعات من أكبر مضلع إلى أصغرها. ملاحظة: يجب ألا تتداخل المضلعات جزئيًا وإلا فإن السلوك غير معرف.
قسم النص	يُعرف ككتلة `<text>`. يتم البحث عن كل كائن خريطة معروض لتحديد ما إذا كان يجب عرض النص وكيف يجب عرضه. معلمات البحث (الإدخال): `tag`، `value`، `zoom`، `nameTag` (يتم فحص كل علامة نصية). نتيجة البحث (الإخراج): `textOnPath`، `textMinDistance` (الهامش بين النصوص المتطابقة مثل أسماء الطرق، المراجع)، `textSize`، `textColor`، `textHaloRadius`، `textOrder`، `textDy`، `textBold`، `nameTag2` (اسم إضافي بين قوسين إذا كان موجودًا)، `textShield` (خلفية حول النص)، `icon` (أيقونة بدلاً من النص)، `textItalic`، `textWrapWidth`، `intersectionMargin` (هامش إضافي لعدم تداخل النص).
قسم النقطة	يُعرف ككتلة `<point>`. يتم البحث عن كل كائن خريطة نقطي معروض (مُعرف في قسم `order`) في هذا القسم لتحديد كيفية عرضه. معلمات البحث (الإدخال): `tag`، `value`، `zoom`، `e`. نتيجة البحث (الإخراج): `shield` (درع الأيقونة)، `icon`، `iconVisibleSize` (مساحة إضافية لعدم تشويش الأيقونات)، `iconOrder`، `intersectionSizeFactor`.
قسم المضلع	يُعرف ككتلة `<polygon>`. يتم البحث عن كل كائن خريطة مضلع معروض (مُعرف في قسم `order`) في هذا القسم لتحديد كيفية عرضه. معلمات البحث (الإدخال): `tag`، `value`، `zoom`. نتيجة البحث (الإخراج): `color` (لون لملء المضلع)، `shader` (ملء المضلع بنفس الأيقونة)، `color_2, color_N` (لون الحد حول المضلع)، `strokeWidth_2` (عرض الحد)، `pathEffect_2`، `cap_2`.
قسم الخط	يُعرف ككتلة `<line>`. يتم البحث عن كل كائن خريطة خطي معروض في هذا القسم لتحديد كيفية عرضه. يمكن عرض كائن خط واحد كخطوط متعددة مدمجة تصل إلى -2 طبقة أدناه وتصل إلى 7 طبقات في الأعلى. معلمات البحث (الإدخال): `tag`، `value`، `zoom`، `nameTag` (يتم فحص كل علامة نصية). نتيجة البحث (الإخراج): `color, color_` (لون الحد حول المضلع)، `strokeWidth, strokeWidth_` (عرض الحد)، `pathEffect, pathEffect_` (تأثير المسار)، `cap, cap_` (BUTT، ROUND، SQUARE)، `pathIcon`، `pathIconStep`، `shadowRadius` (ظل حول الخط).

محددات ميزات الخريطة

لتحديد السمات التي يجب استردادها من نمط العرض، يتم إكمال إجراء البحث التالي:

ابحث عن <case> الأكثر داخلية التي تتوافق مع معلمات إدخال البحث tag/value/zoom، على سبيل المثال، بالنسبة لـ highway=primary - سيتم العثور على <case tag="highway" value="primary">.
يتم تطبيق جميع الأجزاء الداخلية لـ <case> بالتسلسل العميق ويتم جمع معلمات الإخراج
<case><apply output="1"/><apply_if zoom="15" output="2"> <case> - سيكون الإخراج 2 في حالة zoom=15 وسيكون الإخراج 1 بخلاف ذلك.
يتم التحقق مما إذا كان <case> جزءًا من أي <switch>، وإذا كان كذلك، فسيتم تقييم جميع apply و apply_if لهذا التبديل أيضًا

قواعد التقييم:

في كل "حالة"، يتم فحص سمات إدخال apply_if، switch، apply للمطابقة (تقييمها إلى صحيح)، وإلا يتم تخطي القسم ولا يتم جمع سمات الإخراج.
يتم تقييم جميع القواعد بالتسلسل ويمكن تجاوز معلمات الإخراج بواسطة القواعد التالية
additional=? هي سمة إدخال خاصة تتحقق من العلامات الإضافية للكائن
معلمات نمط الخريطة هي معلمات بحث إدخال بالإضافة إلى tag/value/zoom
- مثال: <apply_if nightMode="false" streetLightingNight="false" shield="street_lamp_lit_no_shield"/>. معلمات الإدخال: nightMode، streetLightingNight؛ معلمات الإخراج - shield.

السمات (الخاصة) والثوابت

يمكن تبادل ثوابت العرض وسمات العرض ويمكن استخدامها لتبسيط نمط العرض وتجنب النسخ واللصق للقيم أو كتل التعليمات البرمجية. في حالة كون السمة مثل color قيمة واحدة، فمن المفضل استخدام ثابت العرض لأنه يسرع بشكل كبير أداء نمط العرض.

يمكن استخدام ثوابت العرض بقيمة واحدة فقط: <renderingConstant name="motorwayShadowRadius" value="1.6"/> ولاحقًا في محددات الميزات كـ <apply_if shadowRadius="$motorwayShadowRadius"/>.

يمكن أن تحتوي سمات العرض على بنية مضمنة مع محددات إضافية وإخراج إحدى السمات التالية (attrColorValue، attrBoolValue، attrFloatValue، attrIntValue، attrStringValue). مثال:

    <renderingAttribute name="motorroadShadowColor">
		<case attrColorValue="#5f5fff"/>
	</renderingAttribute>
    .....
    <case showAccess="true" additional="motorroad=yes" attrColorValue="$motorroadShadowColor"/>

سمات خاصة

السمات الخاصة هي <renderingAttribute > التي لا تستخدمها المحددات ولكن تستخدم مباشرة بواسطة الكود للاستعلام عن ميزة معينة يتم رسمها في التطبيق مثل مسار التنقل، المسطرة، مسار GPX، إلخ.

السمة الخاصة	الوصف
`measureDistanceLine`	عرض الخط لميزة تخطيط المسار
`markerGuideline`، `markerPlanRouteline`	عرض الخطوط إلى العلامات
`route`	عرض مسار التنقل
`gpx`	عرض مسار GPX
`publicTransportLine`	عرض مسار تنقل النقل العام
`walkingRouteLine`	عرض تنقل النقل العام: مسار المشاة بين المحطات
`rulerLineFont`، `rulerLine`، `rulerCircleAlt`، `rulerCircle`	كيفية عرض أداة Radius-Ruler وقياس المسافة بالنقر

`defaultColor`	اللون الافتراضي لملء الخريطة (تبديل وضع الليل / النهار)
`shadowRendering`	داخليًا كيفية عرض الظل باستخدام Skia

`routeInfo_*`	مثال: `routeInfo_surface`، `routeInfo_roadClass` تنتج فئات الطرق التي سيتم عرضها في أسطورة المسار.

`polygonMinSizeToDisplay`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة
`roadDensityZoomTile`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة
`roadsDensityLimitPerTile`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة
`defaultSymbolPathSpacing`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة
`defaultBlockPathSpacing`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة
`globalPathPadding`	داخليًا كيفية عرض الخطوط الصغيرة والمضلعات الصغيرة

`debugTextDisplayBBox`	سمات لتصحيح أخطاء عرض النص وتحديد المواقع
`debugTextDisplayShieldBBox`	سمات لتصحيح أخطاء عرض النص وتحديد المواقع
`debugTextDoNotFindIntersections`	سمات لتصحيح أخطاء عرض النص وتحديد المواقع
`debugTextDoNotFindIntersectionsSameName`	سمات لتصحيح أخطاء عرض النص وتحديد المواقع
`debugTextDisplayShortRoadNames`	سمات لتصحيح أخطاء عرض النص وتحديد المواقع

معلمات نمط الخريطة

تسمح معلمات نمط الخريطة بدمج أنماط عرض متعددة ضمن تعريف ملف واحد، أي لا توجد حاجة لامتلاك ملف "my_custom_style_night_mode.render.xml" منفصل، فمن الممكن تحديد معلمة مثل night_mode (ممكنة افتراضيًا) وتخصيص قواعد معينة (مثل الألوان) باستخدام هذه المعلمة. لاحقًا في واجهة المستخدم، من الممكن تبديل هذه المعلمة بسهولة والحصول على نمط خريطة مختلف في OsmAnd.

إليك تعريف معلمة baseAppMode. possibleValues هي القيم التي ستعرض في واجهة مستخدم OsmAnd، category تساعد في تحديد فئة واجهة المستخدم التي تنتمي إليها هذه الخاصية.

<renderingProperty attr="baseAppMode" name="Default Rendering mode" description="Map optimization for respective User Profile based on base (parent) profile"
		type="string" possibleValues="default, car, bicycle, pedestrian, public_transport, boat, ski"/>

لاحقًا في نمط التحديد، يمكنك تحديد متى يمكن تطبيق هذا المحدد، أي لوضع التطبيق المحدد من قبل المستخدم

<renderingAttribute name="roadsDensityLimitPerTile">
		<!-- Number of roads to display per tile -->
		<case moreDetailed="true" attrIntValue="55"/>
		<case baseAppMode="pedestrian" attrIntValue="40"/>
		<case baseAppMode="bicycle" attrIntValue="40"/>
		<case attrIntValue="60"/>
	</renderingAttribute>

لذلك إذا اختار المستخدم moreDetailed=true، فستكون قيمة الكثافة الناتجة 55، وإذا كان baseAppMode=pedestrian (معلمة أخرى)، فستكون 40، وإلا 60.

أقسام نمط الخريطة​

محددات ميزات الخريطة​

السمات (الخاصة) والثوابت​

سمات خاصة​

معلمات نمط الخريطة​

أقسام نمط الخريطة

محددات ميزات الخريطة

السمات (الخاصة) والثوابت

سمات خاصة

معلمات نمط الخريطة