Mercurial > games > semicongine
annotate tests/test_vulkan_wrapper.nim @ 176:36e10cc04a33
fix: bad audio buffer handling, reduce latency (unbearable on windows)
author | Sam <sam@basx.dev> |
---|---|
date | Tue, 02 May 2023 02:13:46 +0700 |
parents | 061054515d28 |
children | de9dff24c422 |
rev | line source |
---|---|
96 | 1 import std/options |
2 | |
117 | 3 import semicongine |
99
4deffc94484a
add: vertex and (initial) shader types and methods
Sam <sam@basx.dev>
parents:
98
diff
changeset
|
4 |
104 | 5 proc diagnostics(instance: Instance) = |
94 | 6 # diagnostic output |
115 | 7 # print basic driver infos |
8 echo "Layers" | |
9 for layer in getLayers(): | |
10 echo " " & layer | |
11 echo "Instance extensions" | |
12 for extension in getInstanceExtensions(): | |
13 echo " " & extension | |
14 | |
93 | 15 echo "Devices" |
16 for device in instance.getPhysicalDevices(): | |
17 echo " " & $device | |
96 | 18 echo " Rating: " & $device.rateGraphics() |
93 | 19 echo " Extensions" |
20 for extension in device.getExtensions(): | |
21 echo " " & $extension | |
96 | 22 echo " Properties" |
23 echo " " & $device.getProperties() | |
24 echo " Features" | |
25 echo " " & $device.getFeatures() | |
93 | 26 echo " Queue families" |
27 for queueFamily in device.getQueueFamilies(): | |
28 echo " " & $queueFamily | |
94 | 29 echo " Surface present modes" |
96 | 30 for mode in device.getSurfacePresentModes(): |
94 | 31 echo " " & $mode |
32 echo " Surface formats" | |
96 | 33 for format in device.getSurfaceFormats(): |
94 | 34 echo " " & $format |
93 | 35 |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
36 proc scene_different_mesh_types(): Entity = |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
37 result = newEntity("root", |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
38 newEntity("triangle1", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
39 positions=[newVec3f(0.0, -0.5), newVec3f(0.5, 0.5), newVec3f(-0.5, 0.5)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
40 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
41 )), |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
42 newEntity("triangle1b", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
43 positions=[newVec3f(0.0, -0.4), newVec3f(0.4, 0.4), newVec3f(-0.4, 0.5)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
44 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
45 )), |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
46 newEntity("triangle2a", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
47 positions=[newVec3f(0.0, 0.5), newVec3f(0.5, -0.5), newVec3f(-0.5, -0.5)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
48 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
49 indices=[[0'u16, 2'u16, 1'u16]] |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
50 )), |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
51 newEntity("triangle2b", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
52 positions=[newVec3f(0.0, 0.4), newVec3f(0.4, -0.4), newVec3f(-0.4, -0.4)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
53 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
54 indices=[[0'u16, 2'u16, 1'u16]] |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
55 )), |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
56 newEntity("triangle3a", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
57 positions=[newVec3f(0.4, 0.5), newVec3f(0.9, -0.3), newVec3f(0.0, -0.3)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
58 colors=[newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
59 indices=[[0'u32, 2'u32, 1'u32]], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
60 autoResize=false |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
61 )), |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
62 newEntity("triangle3b", newMesh( |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
63 positions=[newVec3f(0.4, 0.5), newVec3f(0.9, -0.3), newVec3f(0.0, -0.3)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
64 colors=[newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0)], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
65 indices=[[0'u32, 2'u32, 1'u32]], |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
66 autoResize=false |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
67 )), |
113
7b695fb335ed
did: first final implementation of scene-graph <-> pipeline connection, not working yet
Sam <sam@basx.dev>
parents:
112
diff
changeset
|
68 ) |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
69 for mesh in allComponentsOfType[Mesh](result): |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
70 mesh.setInstanceData("translate", @[newVec3f()]) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
71 |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
72 proc scene_simple(): Entity = |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
73 var mymesh1 = newMesh( |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
74 positions=[newVec3f(0.0, -0.3), newVec3f(0.3, 0.3), newVec3f(-0.3, 0.3)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
75 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
76 ) |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
77 var mymesh2 = newMesh( |
123
55be3579dc30
did: refactor mesh code, prepare for instance-data
Sam <sam@basx.dev>
parents:
122
diff
changeset
|
78 positions=[newVec3f(0.0, -0.5), newVec3f(0.5, 0.5), newVec3f(-0.5, 0.5)], |
55be3579dc30
did: refactor mesh code, prepare for instance-data
Sam <sam@basx.dev>
parents:
122
diff
changeset
|
79 colors=[newVec3f(1.0, 0.0, 0.0), newVec3f(0.0, 1.0, 0.0), newVec3f(0.0, 0.0, 1.0)], |
55be3579dc30
did: refactor mesh code, prepare for instance-data
Sam <sam@basx.dev>
parents:
122
diff
changeset
|
80 ) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
81 var mymesh3 = newMesh( |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
82 positions=[newVec3f(0.0, -0.6), newVec3f(0.6, 0.6), newVec3f(-0.6, 0.6)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
83 colors=[newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0), newVec3f(1.0, 1.0, 0.0)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
84 indices=[[0'u32, 1'u32, 2'u32]], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
85 autoResize=false |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
86 ) |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
87 var mymesh4 = newMesh( |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
88 positions=[newVec3f(0.0, -0.8), newVec3f(0.8, 0.8), newVec3f(-0.8, 0.8)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
89 colors=[newVec3f(0.0, 0.0, 1.0), newVec3f(0.0, 0.0, 1.0), newVec3f(0.0, 0.0, 1.0)], |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
90 indices=[[0'u16, 1'u16, 2'u16]], |
125 | 91 instanceCount=2 |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
92 ) |
126 | 93 mymesh1.setInstanceData("translate", @[newVec3f(0.3, 0.0)]) |
94 mymesh2.setInstanceData("translate", @[newVec3f(0.0, 0.3)]) | |
95 mymesh3.setInstanceData("translate", @[newVec3f(-0.3, 0.0)]) | |
96 mymesh4.setInstanceData("translate", @[newVec3f(0.0, -0.3), newVec3f(0.0, 0.5)]) | |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
97 result = newEntity("root", newEntity("triangle", mymesh4, mymesh3, mymesh2, mymesh1)) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
98 |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
99 proc scene_primitives(): Entity = |
125 | 100 var r = rect(color="ff0000") |
101 var t = tri(color="0000ff") | |
102 var c = circle(color="00ff00") | |
126 | 103 setInstanceData[Vec3f](r, "translate", @[newVec3f(0.5, -0.3)]) |
104 setInstanceData[Vec3f](t, "translate", @[newVec3f(0.3, 0.3)]) | |
105 setInstanceData[Vec3f](c, "translate", @[newVec3f(-0.3, 0.1)]) | |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
106 result = newEntity("root", t, r, c) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
107 |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
108 proc main() = |
127 | 109 var engine = initEngine("Test") |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
110 |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
111 # INIT RENDERER: |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
112 const |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
113 vertexInput = @[ |
168 | 114 attr[Vec3f]("position", memoryPerformanceHint=PreferFastRead), |
115 attr[Vec3f]("color", memoryPerformanceHint=PreferFastWrite), | |
125 | 116 attr[Vec3f]("translate", perInstance=true) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
117 ] |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
118 vertexOutput = @[attr[Vec3f]("outcolor")] |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
119 uniforms = @[attr[float32]("time")] |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
120 fragOutput = @[attr[Vec4f]("color")] |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
121 vertexCode = compileGlslShader( |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
122 stage=VK_SHADER_STAGE_VERTEX_BIT, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
123 inputs=vertexInput, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
124 uniforms=uniforms, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
125 outputs=vertexOutput, |
127 | 126 main="""gl_Position = vec4(position + translate, 1.0); outcolor = color;""" |
123
55be3579dc30
did: refactor mesh code, prepare for instance-data
Sam <sam@basx.dev>
parents:
122
diff
changeset
|
127 ) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
128 fragmentCode = compileGlslShader( |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
129 stage=VK_SHADER_STAGE_FRAGMENT_BIT, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
130 inputs=vertexOutput, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
131 uniforms=uniforms, |
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
132 outputs=fragOutput, |
127 | 133 main="color = vec4(outcolor, 1);" |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
134 ) |
135 | 135 var renderPass = engine.gpuDevice.simpleForwardRenderPass(vertexCode, fragmentCode) |
131
11666d28e04d
add: recreation of swapchain (at least on linux, windows will likely fail, needs testing
Sam <sam@basx.dev>
parents:
129
diff
changeset
|
136 engine.setRenderer(renderPass) |
124
cb9e27a30165
fix: completely overhole buffer handling for drawing, fix shit
Sam <sam@basx.dev>
parents:
123
diff
changeset
|
137 |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
138 # INIT SCENES |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
139 var scenes = [scene_simple(), scene_different_mesh_types(), scene_primitives()] |
127 | 140 var time = initShaderGlobal("time", 0.0'f32) |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
141 for scene in scenes.mitems: |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
142 scene.components.add time |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
143 engine.addScene(scene, vertexInput) |
109 | 144 |
115 | 145 # MAINLOOP |
111
6fd10b7e2d6a
did: allow runtime shader-input definitions
Sam <sam@basx.dev>
parents:
109
diff
changeset
|
146 echo "Setup successfull, start rendering" |
128
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
147 for i in 0 ..< 3: |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
148 for scene in scenes: |
9901ec3831d1
did: finish refactoring of render pipeline, yipi! :)
Sam <sam@basx.dev>
parents:
127
diff
changeset
|
149 for i in 0 ..< 1000: |
146 | 150 if engine.updateInputs() != Running or engine.keyIsDown(Escape): |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
151 engine.destroy() |
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
152 return |
146 | 153 setValue[float32](time.value, get[float32](time.value) + 0.0005) |
131
11666d28e04d
add: recreation of swapchain (at least on linux, windows will likely fail, needs testing
Sam <sam@basx.dev>
parents:
129
diff
changeset
|
154 engine.renderScene(scene) |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
155 echo "Rendered ", engine.framesRendered, " frames" |
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
156 echo "Processed ", engine.eventsProcessed, " events" |
114
056e08dfad10
yay: first triangle rendering with new engine implmentation
Sam <sam@basx.dev>
parents:
113
diff
changeset
|
157 |
056e08dfad10
yay: first triangle rendering with new engine implmentation
Sam <sam@basx.dev>
parents:
113
diff
changeset
|
158 # cleanup |
96 | 159 echo "Start cleanup" |
127 | 160 engine.destroy() |
129
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
161 |
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
162 when isMainModule: |
15d37022625c
add: input handling, small refactoring for renderer
Sam <sam@basx.dev>
parents:
128
diff
changeset
|
163 main() |