Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update information about ECW support in FAQ #522

Merged
merged 8 commits into from
Jan 21, 2025
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 11 additions & 5 deletions content/resources/support/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,14 +74,20 @@ after locations of our developer meetings.

### Can I open ECW files with QGIS?

Yes you can... BUT depending on your Operating System, it is more or less difficult.
ECW is a proprietary file format. It is not included on all platforms out of the box.

If you are under Windows and are using the OSGeo4w installer, it is included.
**Platform specific notes:**

If you are using macOS, you can find the ECW plugin and install instructions at
https://www.kyngchaos.com/software/frameworks
***Windows***: If you are under Windows and are using the OSGeo4w installer, it is included.
Copy link
Contributor

@agiudiceandrea agiudiceandrea Jan 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AFAIK, it's not so simple. We have 2 OSGeo4W installers:

  • an OSGeo4W stand-alone all-in-one .msi installer:
    image
    the ECW driver is installed by default

  • an OSGeo4W "Network installer":
    image
    the installation of the ECW driver depends on what option is selected:

    • "Express Install" mode: the ECW driver is installed by default
    • "Advanced Install" mode: the ECW driver is installed by default if the qgis-full package or the qgis-ltr-full package is installed or if the gdal-ecw package is manually installed.

https://qgis.org/resources/installation-guide/#osgeo4w-installer

So, probably we can only refer to the "OSGeo4W stand-alone all-in-one .msi installer". Ping @jef-n.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

proposal:

"In OSGeo4W the driver is in the gdal-ecw package which is included in the standalone installer."

I wonder if "the standalone installer" is de adequate term.

It doesn't have any title over here (which in turn makes me wonder if we could make this page simpler, see also #374):

image

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if "the standalone installer" is de adequate term.

It's the "name" previously used for such installer, but now doesn't have a "name"...
image

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about the following changes in the FAQ and the download page:

In the FAQ

image

Download page

Add the "name"
image

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For the title, I would just say "Standalone installer" or "QGIS Standalone Installer" (and not use the term OSGeo4W in there)
Maybe @timlinux has also some ideas (he self-assigned #374 a few weeks back)


For other instructions, e.g. look here: https://www.faunalia.eu/en/blog/2019-05-21_ecw_support
***MacOs***: If you are using macOS, you can download the DMG file from [QGIS Downloads](https://qgis.org/download/). This file is built using the [QGIS-Mac-Packager](https://github.com/qgis/QGIS-Mac-Packager) repository, which includes the necessary ECW driver.
Xpirix marked this conversation as resolved.
Show resolved Hide resolved

***Linux***: By default, most Linux distributions do not include ECW support for QGIS. However, you can find discussions and solutions for adding this support on various resources for guidance.

For Ubuntu for example, you can check out the following thread:
Xpirix marked this conversation as resolved.
Show resolved Hide resolved
- [Github - GDAL: How open ECW Maps in QGIS 3.22](https://github.com/OSGeo/gdal/issues/8239)
- [Reddit - QGIS: Problem loading ECW file in Ubuntu (Linux)](https://www.reddit.com/r/QGIS/comments/icw98f/problem_loading_ecw_file_in_ubuntu_linux/?rdt=54968)
- [GIS Stack Exchange: Installing QGIS with ECW support on ubuntu 20.04](https://gis.stackexchange.com/questions/429214/installing-qgis-with-ecw-support-on-ubuntu-20-04/434980#434980).

### How can I get a VPAT / HECVAT / other US compliance form or information?

Expand Down
2 changes: 0 additions & 2 deletions playwright/ci-test/tests/07-support-pages.spec.ts
Original file line number Diff line number Diff line change
Expand Up @@ -58,8 +58,6 @@ test.describe("Resources Pages", () => {
await expect(faqPage.qgisGitHubLink).toBeVisible();
await expect(faqPage.citeQGISUserGuide).toBeVisible();
await expect(faqPage.preElements).toBeVisible();
await expect(faqPage.kyngchaosLink).toBeVisible();
await expect(faqPage.faunaliaLink).toBeVisible();
await expect(faqPage.buildingQGISFromSourceLink).toBeVisible();

for (const text of faqPage.textList) {
Expand Down
8 changes: 0 additions & 8 deletions playwright/ci-test/tests/fixtures/faq-page.ts
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,6 @@ export class FaqPage {
public readonly qgisGitHubLink: Locator;
public readonly citeQGISUserGuide: Locator;
public readonly preElements: Locator;
public readonly kyngchaosLink: Locator;
public readonly faunaliaLink: Locator;
public readonly buildingQGISFromSourceLink: Locator;
constructor(public readonly page: Page) {
this.pageBody = this.page.locator("body");
Expand All @@ -56,12 +54,6 @@ export class FaqPage {
.locator("p")
.filter({ hasText: "Cite the QGIS User Guide" });
this.preElements = this.page.locator("pre");
this.kyngchaosLink = this.page.getByRole("link", {
name: "https://www.kyngchaos.com/",
});
this.faunaliaLink = this.page.getByRole("link", {
name: "https://www.faunalia.eu/en/",
});
this.buildingQGISFromSourceLink = this.page.getByRole("link", {
name: "Building QGIS from source",
});
Expand Down
Loading