Some content could not load. We could not load files from our content delivery networks (CDN).
Your network may be blocking access. Ask your IT to allow loading from: .
Network domains required
We use these CDNs to deliver the files the site needs to run, please allow the following:
Domains to allow Used for
cdn.jsdelivr.net styles and JavaScript libraries.
cdnjs.cloudflare.com JavaScript libraries and icons.
code.jquery.com jQuery and jQuery UI.
pixelpad.io, cdn.pixelpad.io CDN of images, sounds, and application files.
cdn.datatables.net Interactive tables.
fonts.googleapis.com, fonts.gstatic.com Fonts stylesheets and font files.
s3.us-west-1.amazonaws.com, s3-us-west-1.amazonaws.com Project files stored on Amazon S3.
vmwan2cvlyzeklq4knz63qh6d40lewka.lambda-url.us-west-1.on.aws Amazon AWS Project play counters.
nexushud.org Learning assistant.
u45ivsqoja6u3sk7zaliv37zq40hpbxk.lambda-url.us-west-1.on.aws Amazon AWS AI character responses, when used.
  • 探索
  • 學習
  • 登入
  • 簡介
  • 遊戲
  • Start 與 Loop
  • 物件
  • 精靈
  • 動畫
  • 聲音
  • 房間
  • 輸入
  • 碰撞
  • 函式
  • 攝影機
  • FPS
  • 文字
  • 繪圖
  • 濾鏡
  • 多人連線
  • AI

PixelPAD 2D - 濾鏡

濾鏡

濾鏡(有時稱為著色器)讓我們能利用顯示卡製作特殊的視覺效果。PixelPAD2D 提供了一系列可以使用的濾鏡。只要把它們加到 GameObject 或 Game 物件本身,就能使用。

add_filter(obj: GameObject, filter : Filter) -> filter id

範例
說明
為物件加上濾鏡;若設在 Game 物件上,則會套用到全域。
參數
obj
要套用濾鏡的物件。也可以使用 Game 物件,這會將濾鏡套用到全域

filter
要使用的濾鏡。例如,呼叫 new_glow_filter() 可以建立新的發光濾鏡

回傳值
濾鏡 id。用這個濾鏡 id 來移除濾鏡

remove_filter(obj: GameObject, filterid : number) -> Filter

範例
說明
從特定物件移除濾鏡。
參數
obj
要移除濾鏡的物件。

filter id
The filter id, returned from add_filter()

回傳值
None

new_adjustment_filter(filterSettings : dictionary) -> Filter

範例
說明
這個濾鏡可以改變 GameObject 精靈的整體顏色、亮度和飽和度。
參數
filterSettings
存放濾鏡設定的字典。
預設值:2

filterSettings["gamma"]
How much to adjust the object's gamma.
Default: 2

filterSettings["saturation"]
How much to adjust the object's saturation.
Default: 2

filterSettings["contrast"]
How much to adjust the object's constrast.
Default: 1

filterSettings["brightness"]
How much to adjust the object's brightness.
Default: 1

filterSettings["red"]
How much to adjust the object's red.
Default: 1

filterSettings["green"]
How much to adjust the object's green.
Default: 1

filterSettings["blue"]
How much to adjust the object's blue.
Default: 1

filterSettings["alpha"]
How much to adjust the object's alpha.
Default: 1

回傳值
濾鏡

new_adv_bloom_filter(filterSettings : dictionary) -> Filter

範例
說明
這個濾鏡可以為 GameObject 的精靈加上光暈。光暈效果會讓精靈看起來更像用真實相機拍出來的樣子。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["threshold"]
The threshold of brightness at which bloom will start appearing.
Default: 0.5

filterSettings["bloomScale"]
The intensity of the effect.
Default: 1.0

filterSettings["brightness"]
How bright the bloom effect will be.
Default: 1.0

filterSettings["blur"]
The amount to blur the bloom.
Default: 8

filterSettings["quality"]
quality of the blur
Default: 4

filterSettings["kernels"]
the kernels of the blur
Default: null

filterSettings["pixelSize"]
The pixel size of the Blur
Default: 1

filterSettings["resolution"]
The resolution of the Blur.
Default: Resolution of canvas

回傳值
濾鏡

new_ascii_filter(filterSettings : dictionary) -> Filter

範例
說明
讓物件的精靈看起來像 ASCII 藝術。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["size"]
The font size of the ascii text.
Default: 8

回傳值
濾鏡

new_bevel_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上斜角效果。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["rotation"]
The angle of the light in degrees.
Default: 45

filterSettings["thickness"]
The tickness of the bevel.
Default: 2

filterSettings["lightColor"]
Color of the light.
Default: 0xffffff

filterSettings["lightAlpha"]
Alpha of the light.
Default: 0.7

filterSettings["shadowColor"]
Color of the shadow.
Default: 0x000000

filterSettings["shadowAlpha"]
Alpha of the shadow.
Default: 0.7

回傳值
濾鏡

new_bulge_pinch_filter(filterSettings : dictionary) -> Filter

範例
說明
讓物件的精靈看起來像從一個點向外拉伸。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["center"]
Coordinates to set the bulge or pinch
Default: [0.5,0.5]

filterSettings["radius"]
The radius of the stretch.
Default: 100

filterSettings["strength"]
The strength of the stretch.
Default: 1

回傳值
濾鏡

new_color_map_filter(filterSettings : dictionary) -> Filter

範例
說明
透過對應另一個精靈來調整精靈的整體顏色。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["colorMap"]
The sprite to map the colors to.
Default: new_sprite('nosprite.png')

filterSettings["nearest"]
If it should use the nearest color to the original (True/False)
Default: False

filterSettings["mix"]
How much the colors mix.
Default: 1

回傳值
濾鏡

new_color_replace_filter(filterSettings : dictionary) -> Filter

範例
說明
把一種顏色換成另一種顏色
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["originalColor"]
The RGB that will be changed.
Default: [1,0,0]

filterSettings["newColor"]
The color to change to in RGB
Default: [0,0,1]

filterSettings["epsilon"]
Tolerance or sensitivity.
Default: 0.8

回傳值
濾鏡

new_convolution_filter(filterSettings : dictionary) -> Filter

範例
說明
卷積濾鏡會結合 GameObject 精靈中的像素,套用矩陣卷積效果。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["matrix"]
A 9 point array that holds the values for the matrix calculations.
Default: [0.5,0.5,0.5,0.5,0,0,0,0,0]

filterSettings["width"]
The width of sprite you are using.
Default: 200

filterSettings["height"]
The height of the sprite you are using.
Default: 200

回傳值
濾鏡

new_cross_hatch_filter() -> Filter

範例
說明
交叉排線濾鏡會在精靈上疊加黑白交叉排線圖樣。
參數
None
None

回傳值
濾鏡

new_crt_filter(filterSettings : dictionary) -> Filter

範例
說明
CRT 濾鏡讓精靈看起來像是透過 CRT 映像管電視播放。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["curvature"]
How curved the CRT display appears.
Default: 1.0

filterSettings["lineWidth"]
The width of the CRT lines.
Default: 1.0

filterSettings["lineConstrast"]
The contrast of the lines on the rest of the sprite.
Default: 0.25

filterSettings["verticalLine"]
If it is a horizonal or vertical line (True/False)
Default: False

filterSettings["noise"]
The amount of noise to add to the filter.
Default: 0.3

filterSettings["noiseSize"]
The seed the noise filter should use.
Default: 1.0

filterSettings["seed"]
The seed for the CRT filter.
Default: 0

filterSettings["vignetting"]
How much vignetting to do, darkening the pixels closest to the sprite's corners.
Default: 0.3

filterSettings["vignettingAlpha"]
The alpha the vignetting should take on.
Default: 1.0

filterSettings["vignettingBlur"]
How blurry the vignetting should be.
Default: 0.3

filterSettings["time"]
Used to animate the filter, increase it over time to have the CRT animate.
Default: 0

回傳值
濾鏡

new_dot_filter(filterSettings : dictionary) -> Filter

範例
說明
為精靈套用黑白點描濾鏡。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["scale"]
The scale at which the dots should be drawn.
Default: 1

filterSettings["angle"]
The angle a which the dot pattern should be.
Default: 5

回傳值
濾鏡

new_drop_shadow_filter(filterSettings : dictionary) -> Filter

範例
說明
為 GameObject 的精靈加上陰影。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["rotation"]
The angle a which the shadow should appear.
Default:45

filterSettings["distance"]
How far the shadow should go from the GameObject.
Default:5

filterSettings["color"]
The color of the shadow.
Default:0x000000

filterSettings["alpha"]
The alpha of the blur.
Default:0.5

filterSettings["shadowOnly"]
If it should only draw the shadow and not the sprite. (True/False)
Default:False

filterSettings["blur"]
How blurry the drop shadow should be.
Default:2

filterSettings["quality"]
The quality of the blur.
Default:3

filterSettings["kernels"]
The kernels of the blur
Default:null

filterSettings["pixelSize"]
the pixelSize of the blur
Default:1

filterSettings["resolution"]
The resolution of the blur
Default:Resolution of the Canvas

回傳值
濾鏡

new_emboss_filter(filterSettings : dictionary) -> Filter

範例
說明
浮雕是一種電腦繪圖技術。GameObject 精靈的每個像素都會被替換成陰影或亮部。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["strength"]
The strength of the filter.
Default: 5

回傳值
濾鏡

new_glitch_filter(filterSettings : dictionary) -> Filter

範例
說明
浮雕是一種電腦繪圖技術。GameObject 精靈的每個像素都會被替換成陰影或亮部。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["slices"]
The maximum number of slices.
Default: 5

filterSettings["offset"]
The maximum offset amount of slices.
Default: 100

filterSettings["direction"]
The angle in degree of the offset of slices.
Default: 0

filterSettings["fillMode"]
The fill mode of the space after the offset. Acceptable values: 1,2,3,4,5
Default: 0

filterSettings["seed"]
A seed value for randomizing glitch effect.
Default: 0

filterSettings["average"]
true will divide the bands roughly based on equal amounts where as setting to false will vary the band sizes dramatically (more random looking).
Default: False

filterSettings["minSize"]
Minimum size of individual slice. Segment of total sampleSize
Default: 8

filterSettings["sampleSize"]
The resolution of the displacement map texture.
Default: 512

filterSettings["red"]
Red offset
Default: [0,0]

filterSettings["green"]
Green offset
Default: [0,0]

filterSettings["blue"]
Blue offset
Default: [0,0]

回傳值
濾鏡

new_glow_filter(filterSettings : dictionary) -> Filter

範例
說明
這個濾鏡可以在物件周圍沿著精靈輪廓製造發光效果。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["distance"]
How far out it goes. This cannot be changed after filter creation.
Default:10

filterSettings["outerStrength"]
The strength of the glow at the farthest point.
Default:4

filterSettings["innerStrength"]
The strength of the glow at the closest point.
Default:0

filterSettings["color"]
The HEX color code of the glow.
Default:0xffffff

filterSettings["quality"]
The HEX color code of the glow.
Default:0.1

filterSettings["knockout"]
Hide the texture, and only show glow.
Default:False

回傳值
濾鏡

new_godray_filter(filterSettings : dictionary) -> Filter

範例
說明
在 GameObject 的精靈上產生光束。可以做成動畫。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["angle"]
The angle at which the godrays appear.
Default:30

filterSettings["gain"]
Changes the godray's sensitivity.
Default:0.5

filterSettings["lacunarity"]
The intensity of the gaps in the godrays.
Default:2.5

filterSettings["parallel"]
If all the godrays should be parallel.
Default:True

filterSettings["time"]
The time the filter is at. Increase it over time to animate the godrays.
Default:0

filterSettings["center"]
Where the rays originate. Parallel must be set to false.
Default:[0,0]

回傳值
濾鏡

new_kawase_blur_filter(filterSettings : dictionary) -> Filter

範例
說明
模糊 GameObject 的精靈。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["blur"]
The intensity of the blur.
Default:4

filterSettings["quality"]
The blur's quality.
Default:3

filterSettings["clamp"]
Clamps the edges of the GameObject's sprite (True/False)
Default:False

回傳值
濾鏡

new_motion_blur_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上動態模糊濾鏡。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["velocity"]
The strength of the blur x and y
Default:[0,0]

filterSettings["kernelSize"]
The kernelSize of the blur filter. Must be odd number >= 5
Default:5

filterSettings["offset"]
The offset of the blur filter.
Default:0

回傳值
濾鏡

new_multicolor_replace_filter(filterSettings : dictionary) -> Filter

範例
說明
多色替換
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["replacements"]

Default:[[ [1,0,0], [0,0,1] ],[ [0,1,0], [1,1,1] ]]

filterSettings["epsilon"]

Default:0.05

filterSettings["maxColors"]

Default:2

回傳值
濾鏡

new_old_film_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上老電影效果。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["sepia"]
The amount of saturation of sepia effect, a value of 1 is more saturation and closer to 0 is less, and a value of 0 produces no sepia effect
Default:0.3

filterSettings["noise"]
Opacity/intensity of the noise effect between 0 and 1
Default:0.3

filterSettings["noiseSize"]
The size of the noise particles
Default:1.0

filterSettings["scratch"]
How often scratches appear
Default:0.5

filterSettings["scratchDensity"]
The density of the number of scratches
Default:0.3

filterSettings["scratchWidth"]
The width of the scratches
Default:1.0

filterSettings["vignetting"]
The radius of the vignette effect, smaller values produces a smaller vignette
Default:0.3

filterSettings["vignettingAlpha"]
Amount of opacity of vignette
Default:1.0

filterSettings["vignettingBlur"]
Blur intensity of the vignette
Default:0.3

回傳值
濾鏡

new_outline_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上外框。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["thickness"]
The tickness of the outline.
Default:1

filterSettings["color"]
The color of the outline.
Default:0x000000

filterSettings["quality"]
The quality of the outline from 0 to 1, using a higher quality setting will result in slower performance and more accuracy.
Default:0.1

回傳值
濾鏡

new_pixelate_filter(filterSettings : dictionary) -> Filter

範例
說明
可以將 GameObject 的精靈像素化。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["size"]
A two element array that holds the width/height of each pixel.
Default:[10,10]

回傳值
濾鏡

new_radial_blur_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上放射狀模糊。
參數
filterSettings
存放濾鏡設定的字典。
預設值:

filterSettings["angle"]
Sets the angle of the motion for blur effect.
Default:0

filterSettings["center"]
The center of the radial.
Default:[0,0]

filterSettings["kernelSize"]
The kernelSize of the blur filter. But be odd number >= 3
Default:5

filterSettings["radius"]
The maximum size of the blur radius, -1 is infinite
Default:-1

回傳值
濾鏡

new_reflection_filter(filterSettings : dictionary) -> Filter

範例
說明
可以為精靈建立倒影。可以做成動畫。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["mirror"]
If the reflection should be mirrored.
Default:true

filterSettings["boundary"]
The vertical position where the reflection should occur.
Default:0.5

filterSettings["amplitude"]
The strength of the starting/ending positions of the waves.
Default:[0,20]

filterSettings["waveLength"]
The length of the starting/ending positions of the waves.
Default:[30,100]

filterSettings["alpha"]
The alpha values of the starting/ending positions of the waves.
Default:[1,1]

filterSettings["time"]
The time the filter is at. Increase over time to animate.
Default:0

回傳值
濾鏡

new_rgb_split_filter(filterSettings : dictionary) -> Filter

範例
說明
分離物件的 RGB,並為每個 RGB 值加上偏移
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["red"]
Red offset
Default: [-10,0]

filterSettings["green"]
Green offset
Default: [0, 10]

filterSettings["blue"]
Blue offset
Default: [0, 0]

回傳值
濾鏡

new_shockwave_filter(filterInfo : dictionary) -> Filter

範例
說明
建立從一個點向外擴散的動態衝擊波效果。
參數
filterInfo
存放濾鏡資料的字典。

filterInfo["center"]
Where to center the shockwave. Center is relative to the Sprite's top left corner.
Default:[0.5,0.5]

filterInfo["amplitude"]
The strength of the shockwave
Default:.30

filterInfo["wavelength"]
The wave length of the shockwave.
Default:160

filterInfo["speed"]
The speed at which the shockwave moves out if animated using time.
Default:500

filterInfo["brightness"]
The brightness of the shockwave.
Default:1.0

filterInfo["radius"]
The radius of the shockwave when starting.
Default:-1

filterInfo["time"]
The time at which the filter is at. Increase overtime to animate.
Default:0

回傳值
濾鏡

new_simple_lightmap_filter(filterSettings : dictionary) -> Filter

範例
說明
使用精靈為物件加上光照貼圖。
參數
filterSettings
存放濾鏡設定的字典。
預設值:

filterSettings["texture"]
The sprite to use as a lightmap
Default: new_sprite('nosprite.png')

filterSettings["color"]
An RGBA array of the ambient color
Default: [1, 0, 0, 1]

filterSettings["alpha"]
Default alpha set independent of color
Default: 1

回傳值
濾鏡

new_tilt_shift_filter(filterSettings : dictionary) -> Filter

範例
說明
加上移軸濾鏡效果
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["blur"]
How much to blur the effect.
Default:100

filterSettings["gradientBlur"]
The gradient of the blur's effects.
Default:600

回傳值
濾鏡

new_twist_filter(filterSettings : dictionary) -> Filter

範例
說明
為物件加上扭曲濾鏡。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["radius"]
How wide to twist.
Default:200

filterSettings["angle"]
The angle of the twist
Default:4

filterSettings["padding"]
Padding for filter area.
Default:20

回傳值
濾鏡

new_zoom_blur_filter(filterSettings : dictionary) -> Filter

範例
說明
為精靈加上縮放模糊濾鏡。
參數
filterSettings
存放濾鏡設定的字典。

filterSettings["strength"]
The strength of the zoom.
Default:0.1

filterSettings["center"]
Where to center to zoom. [0,0] is the top left corner of the sprite.
Default:[0.5,0.5]

filterSettings["innerRadius"]
The radius of the inner unzoomed area.
Default:0

filterSettings["radius"]
The outer radius of the filter. -1 for infinite.
Default:-1

回傳值
濾鏡
PixelPAD
關於我們
Discord
Arm 版本 3.0.1013
資源
文件
EULA
隱私權政策
聯絡我們
hello@pixelpad.io
繁體中文
English Deutsch Español Français Português 日本語 简体中文 繁體中文 한국어
© 2026 版權所有。
PixelPAD.io
Logo

歡迎回來!

登入後繼續創作

登入或註冊即可儲存你的專案。
忘記密碼?

還沒有帳號?

Logo

建立你的帳號

加入 PixelPad 上成千上萬的創作者

登入或註冊即可儲存你的專案。

已經有帳號了? 登入

Logo

以教育者身分加入

用創意工具,讓你的學生大展身手

建立班級並追蹤學生的學習進度。

已經有帳號了? 登入