> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# SVG shape-rendering crispEdges: kiedy pomaga?

> Sprawdź, kiedy SVG crispEdges pomaga przy znakach opartych na siatce pikseli, kiedy może pogorszyć gładkość krzywych i dlaczego test w przeglądarce w dwóch rozmiarach jest lepszy niż traktowanie wskazówki renderowania jako naprawy.

Source: https://perfectvector.com/pl/blog/svg-shape-rendering-crispedges

Language: pl
Author: Irene Kim
Published: 2026-09-28T08:00:00+09:00
Updated: 2026-09-28T08:00:00+09:00

Używaj `shape-rendering="crispEdges"`, gdy SVG ma celowo ostre, przeważnie proste krawędzie, a test w docelowym rozmiarze wyświetlania daje z tą wartością lepszy efekt. Pozostaw domyślne `auto`, jeśli różnica jest znikoma. W grafice z krzywymi ta wskazówka może sprawić, że krawędź będzie wyglądać bardziej nierówno. Zmienia sposób, w jaki mechanizm renderujący **rysuje** istniejące kształty, a nie same kształty. [Specyfikacja SVG 2](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) określa ją jako wskazówkę i pozwala mechanizmowi renderującemu ograniczyć wygładzanie krawędzi lub wyrównać niektóre krawędzie do pikseli urządzenia.

To rozróżnienie ma znaczenie, jeśli mała ikona wygląda na rozmytą lub logo po eksporcie wydaje się postrzępione. `crispEdges` nie zamieni osadzonego PNG w ścieżki, nie naprawi uszkodzonego konturu ani nie zagwarantuje identycznych pikseli w każdej przeglądarce. Zanim zmienisz cały plik, porównaj jeden reprezentatywny kształt z wartościami `auto`, `crispEdges` i `geometricPrecision` w rozmiarach, w których odbiorcy będą go rzeczywiście oglądać.

> **Wybierz ustawienie odpowiednie do potrzebnych krawędzi**
>
> * **Prostokątna grafika oparta na siatce pikseli:** przetestuj `crispEdges` na odpowiednich kształtach, a następnie sprawdź wynik zarówno w małych, jak i większych rozmiarach.
> * **Krzywe lub zaokrąglone litery:** zacznij od `auto`; wypróbuj `geometricPrecision`, jeśli mechanizm renderujący daje widoczną różnicę.
> * **Szczelina między sąsiadującymi kształtami:** najpierw sprawdź geometrię. Wskazówka renderowania nie zamknie rzeczywistego otworu.
> * **Skalowany PNG wewnątrz SVG:** użyj ustawień skalowania obrazu rastrowego lub odtwórz grafikę jako ścieżki, jeśli celem jest możliwość edycji.

## O co `crispEdges` prosi mechanizm renderujący

SVG ma cztery wartości `shape-rendering`. Są to priorytety, a nie cztery formaty eksportu. Domyślne `auto` pozwala mechanizmowi renderującemu znaleźć równowagę między szybkością, kontrastem krawędzi i dokładnością geometrii. `crispEdges` preferuje silny kontrast krawędzi i może ograniczać ich wygładzanie; `geometricPrecision` preferuje wierne odwzorowanie geometrii. [Dokumentacja atrybutu SVG w MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/shape-rendering) wyjaśnia, że mechanizm renderujący *może* inaczej traktować wszystkie krawędzie lub tylko te zbliżone do poziomych i pionowych. Nie ma obowiązkowego filtra wyostrzającego.

| Wartość              | O co prosi                                     | Przydatny pierwszy test                                    |
| -------------------- | ---------------------------------------------- | ---------------------------------------------------------- |
| `auto`               | Mechanizm renderujący wybiera kompromis        | Punkt odniesienia dla każdego SVG                          |
| `crispEdges`         | Większy kontrast na krawędziach kształtów      | Kwadratowe znaki lub detale przypominające siatkę          |
| `geometricPrecision` | Dokładniejsze odwzorowanie położenia kształtów | Krzywe, przekątne i drobne kontury                         |
| `optimizeSpeed`      | Priorytet szybkości renderowania               | Specjalistyczne zastosowania; nie zakładaj poprawy wyglądu |

Atrybut nadrzędnego elementu SVG może być dziedziczony przez jego kształty potomne, więc zastosowanie go w elemencie głównym może wpłynąć na koło, które powinno pozostać gładkie. Zamiast tego możesz wskazać pojedynczy prostokąt lub ścieżkę. Jeśli jednocześnie obowiązują atrybut prezentacyjny SVG i deklaracja CSS `shape-rendering`, [właściwość CSS ma pierwszeństwo](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/shape-rendering).

## Porównaliśmy te same kształty w dwóch rozmiarach

Stworzyliśmy jeden prostokątny znak oparty na siatce i jeden zakrzywiony kontur jako oryginalne kształty SVG. Kod, wypełnienia i `viewBox` były identyczne we wszystkich trzech kolumnach; zmieniała się tylko wartość `shape-rendering`. Każdy kształt wyrenderowano w rozmiarach 63 i 111 pikseli CSS w Chromium przy powiększeniu przeglądarki 100%. Ilustracja jest zrzutem z przeglądarki z tego lokalnego testu, a nie przedstawieniem wyobrażonego wyniku.

**Ta sama geometria SVG, trzy wskazówki, dwa rozmiary**

![Zrzut z Chromium porównujący ten sam prostokątny znak SVG i zakrzywiony kontur przy ustawieniach auto, crispEdges i geometricPrecision w rozmiarach wyświetlania 63 i 111 pikseli](https://perfectvector.com/blog/svg-shape-rendering-crispedges/render-test.webp)

*Oryginalny zrzut z Chromium przy powiększeniu przeglądarki 100%. Różnica wizualna jest tu niewielka; wskazówka zmienia sposób rysowania pikseli, a nie ścieżki. Przetestuj własny mechanizm renderujący i docelowy rozmiar.*

Żaden z trybów nie zmienia ścieżek. Na tym zrzucie różnice są zbyt małe, by uznać jedno ustawienie za najlepsze we wszystkich przypadkach. Nazwa brzmi jak nazwa narzędzia do naprawy, ale efekt może być niewielki dla konkretnego kształtu, rozmiaru i mechanizmu renderującego. Sprawdź grafikę w rzeczywistym miejscu docelowym, zanim zdecydujesz się pozostawić dodatkowy atrybut.

Było to jedno renderowanie w Chromium, a nie badanie zgodności przeglądarek. Czytnik PDF, edytor graficzny lub przeglądarka internetowa przy innym współczynniku skalowania urządzenia mogą inaczej rasteryzować te same ścieżki. [Definicja w SVG 2](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) celowo pozostawia swobodę wyboru sposobu implementacji.

## Przetestuj na jednym kształcie, zanim zastosujesz wszędzie

Zapisz kopię SVG, a następnie dodaj wskazówkę do reprezentatywnego kształtu. Na przykład zastosuj ją do prostokątnej części ikony, pozostawiając zakrzywiony detal z wartością `auto`:

```xml
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
  <rect x="4" y="4" width="16" height="8" fill="#154b67"
        shape-rendering="crispEdges" />
  <path d="M5 18 Q12 11 19 18" fill="none" stroke="#23a6a1"
        stroke-width="2" shape-rendering="auto" />
</svg>
```

Otwórz plik w docelowej przeglądarce lub aplikacji w małym rozmiarze ikony i w większym rozmiarze. Porównaj go z zapisanym oryginałem, uwzględniając przekątne i krzywe. Jeśli stylizujesz SVG osadzone bezpośrednio w kodzie strony za pomocą CSS, sprawdź, czy jakaś reguła nie nadpisuje atrybutu. Usuń wskazówkę, jeśli nie daje istotnej poprawy; zbędna właściwość utrudnia późniejszą diagnozę różnic w wyświetlaniu.

## Dopasuj rozwiązanie do rzeczywistego objawu

| Objaw                                                         | Co sprawdzić najpierw                                                                            | Lepszy następny krok                                                                                                                                                    |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Kwadratowy znak wygląda na nieostry w jednym rozmiarze        | Porównaj `auto` i `crispEdges` w tym rozmiarze                                                   | Pozostaw wskazówkę tylko wtedy, gdy poprawia docelowy wynik                                                                                                             |
| Koło lub przekątna ma postrzępione krawędzie                  | Sprawdź, czy `crispEdges` jest dziedziczone lub zostało dodane do tego kształtu podczas eksportu | Usuń tę wartość lub porównaj `auto` z `geometricPrecision`                                                                                                              |
| Między stykającymi się wypełnieniami pojawia się cienka linia | Porównaj powiększenie, tło i granice ścieżek                                                     | Skorzystaj z [diagnostyki szczelin w SVG](https://perfectvector.com/pl/blog/svg-gaps-between-shapes); napraw geometrię tylko wtedy, gdy szczelina rzeczywiście istnieje |
| Po powiększeniu pliku nadal widać kwadratowe piksele          | Sprawdź, czy zawiera osadzony obraz rastrowy                                                     | Skorzystaj z [listy kontrolnej dla rozpikselowanego SVG](https://perfectvector.com/pl/blog/svg-looks-pixelated), zamiast zmieniać `shape-rendering`                     |

W przypadku sprite’a PNG, którego wygląd opiera się na dokładnej siatce pikseli, zachowanie obrazu rastrowego może być najlepszym rozwiązaniem. CSS [`image-rendering: pixelated`](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/image-rendering) steruje sposobem próbkowania skalowanego obrazu; to inna właściwość niż SVG `shape-rendering`. [Poradnik konwersji pixel artu](https://perfectvector.com/pl/blog/pixel-art-to-vector) omawia, kiedy zachować siatkę, zbudować kafelki wektorowe lub celowo wygładzić kontur.

## Kiedy przydaje się PerfectVector

Jeśli Twoim jedynym źródłem jest mały, spłaszczony PNG i potrzebujesz **edytowalnych ścieżek**, wskazówka renderowania ich nie zapewni. PerfectVector przydaje się na tym wcześniejszym etapie: przekonwertuj PNG na roboczą wersję SVG, a następnie sprawdź kształty w potrzebnym rozmiarze. Sprawdź obrys, wewnętrzne otwory i drobne detale, zanim wypróbujesz wskazówkę renderowania na wybranych ścieżkach. Wektoryzacja może przekształcić piksele w geometrię; nie potrafi zdecydować, czy schodkowy fragment pixel artu powinien stać się gładką krzywą.

Zachowaj PNG, jeśli oryginalna siatka stanowi finalną grafikę. Jeśli masz już poprawny SVG i tylko jego wygląd w przeglądarce jest dziwny, popraw bezpośrednio sposób wyświetlania lub geometrię. Gdy spłaszczony PNG rzeczywiście wymaga edytowalnych konturów, [utwórz roboczą wersję SVG za pomocą PerfectVector](https://perfectvector.com/pl/convert-png-to-svg), sprawdź jej ścieżki i porównaj renderowanie w przeglądarce w docelowym rozmiarze, zanim dodasz `crispEdges`.

## Najczęściej zadawane pytania

**Czy `crispEdges` usuwa wygładzanie krawędzi ze wszystkich kształtów SVG?**
Nie. Prosi mechanizm renderujący o nadanie priorytetu kontrastowi krawędzi. Specyfikacja dopuszcza różne implementacje, w tym takie, które zmieniają tylko niektóre krawędzie zbliżone do pionowych lub poziomych. Przetestuj wynik w przeglądarce lub aplikacji, której będziesz używać.

**Czy należy dodać `shape-rendering="crispEdges"` do całego SVG?**
Tylko jeśli każdy kształt potomny na tym zyskuje. Wskazówka w elemencie głównym może wpłynąć również na zakrzywione kształty potomne. Zastosowanie atrybutu do jednego prostokątnego kształtu jest łatwiejsze do oceny i zmniejsza ryzyko pogorszenia gładkości krzywej.

**Czy `crispEdges` naprawi białe szczeliny lub rozmyty PNG wewnątrz SVG?**
Nie zamknie rzeczywistej szczeliny ani nie zastąpi pikseli obrazu rastrowego ścieżkami wektorowymi. Najpierw sprawdź geometrię szczeliny. W przypadku skalowanego PNG użyj odpowiedniej metody skalowania obrazu rastrowego lub utwórz edytowalne ścieżki wektorowe, jeśli właśnie tego potrzebujesz.

## Źródła

1. [W3C — SVG 2 shape-rendering property](https://www.w3.org/TR/SVG2/painting.html#ShapeRendering) — Definiuje cztery wartości jako wskazówki dla mechanizmu renderującego i wyjaśnia dopuszczalne kompromisy.
2. [MDN — SVG shape-rendering attribute](https://developer.mozilla.org/en-US/docs/Web/SVG/Reference/Attribute/shape-rendering) — Dokumentuje kształty SVG, do których można zastosować atrybut, dziedziczenie i pierwszeństwo CSS.
3. [MDN — CSS shape-rendering property](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/shape-rendering) — Opisuje działanie właściwości i przyczyny różnic w renderowaniu krzywych.
4. [MDN — CSS image-rendering property](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/image-rendering) — Rozróżnia skalowanie pikseli obrazu rastrowego i renderowanie krawędzi kształtów wektorowych.

## Explore

- [Read the HTML article](https://perfectvector.com/pl/blog/svg-shape-rendering-crispedges)
- [Scratch Convert to Vector: czemu nadal widać piksele](https://perfectvector.com/pl/blog/scratch-convert-bitmap-to-vector.md)
- [z-index w SVG nie działa? Popraw kolejność nakładania ścieżek](https://perfectvector.com/pl/blog/svg-z-index-order.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
